@rsaglobaltech/specgate 0.27.8 → 1.0.0-rc.1

package/dist/scripts/alm/phases.js

@@ -0,0 +1,279 @@
+"use strict";
+/**
+ * The board follows the change (REQ-305, REQ-307).
+ *
+ * A change's phase is read from the repository, never from the board: open
+ * and not yet built, one of its requirements being built, or archived. The
+ * board is told; it is never asked what the change is (ADR-0021). What the
+ * sync has told the board is kept in `.specops/alm-phases.json`, beside the
+ * REQ ↔ issue mapping, so a move already made is not made again and a
+ * sub-issue is never created twice.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PHASES_RELPATH = void 0;
+exports.readPhaseMap = readPhaseMap;
+exports.writePhaseMap = writePhaseMap;
+exports.changeTicket = changeTicket;
+exports.boardChanges = boardChanges;
+exports.namedState = namedState;
+exports.movePhase = movePhase;
+exports.syncPhases = syncPhases;
+exports.syncSubIssues = syncSubIssues;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const YamlLite_1 = require("../../packages/core/src/domain/YamlLite");
+exports.PHASES_RELPATH = path.join(".specops", "alm-phases.json");
+const CHANGES = path.join("docs", "specs", "changes");
+// ── The map ───────────────────────────────────────────────────────────────────
+function readPhaseMap(projectDir) {
+    const mapPath = path.join(projectDir, exports.PHASES_RELPATH);
+    if (!fs.existsSync(mapPath))
+        return {};
+    return JSON.parse(fs.readFileSync(mapPath, "utf8"));
+}
+function writePhaseMap(projectDir, map, dryRun) {
+    const mapPath = path.join(projectDir, exports.PHASES_RELPATH);
+    if (dryRun)
+        return mapPath;
+    fs.mkdirSync(path.dirname(mapPath), { recursive: true });
+    fs.writeFileSync(mapPath, `${JSON.stringify(map, null, 2)}\n`, "utf8");
+    return mapPath;
+}
+// ── Changes and their phase ───────────────────────────────────────────────────
+/** The ticket a change carries: `ticket:`, or the issue `alm pull` opened it from. */
+function changeTicket(yaml) {
+    const ticket = typeof yaml.ticket === "string" ? yaml.ticket.trim() : "";
+    if (ticket)
+        return ticket;
+    const origin = typeof yaml.origin === "string" ? /^alm:(\S+)$/.exec(yaml.origin.trim()) : null;
+    return origin ? origin[1] : null;
+}
+function readYaml(file) {
+    if (!fs.existsSync(file))
+        return {};
+    return ((0, YamlLite_1.parseYamlLite)(fs.readFileSync(file, "utf8")) || {});
+}
+function deltaRequirements(changeDir) {
+    const found = new Set();
+    const walk = (dir) => {
+        if (!fs.existsSync(dir))
+            return;
+        for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+            const full = path.join(dir, e.name);
+            if (e.isDirectory())
+                walk(full);
+            else if (e.name === "spec.md") {
+                for (const m of fs
+                    .readFileSync(full, "utf8")
+                    .matchAll(/^###\s+Requirement:\s+(REQ-\d+)/gm)) {
+                    found.add(m[1]);
+                }
+            }
+        }
+    };
+    walk(path.join(changeDir, "specs"));
+    return [...found];
+}
+/** The local `harness/REQ-NNN` branches: a requirement the harness has started. */
+function harnessBranches(projectDir) {
+    const r = (0, node_child_process_1.spawnSync)("git", ["branch", "--list", "harness/REQ-*", "--format=%(refname:short)"], {
+        cwd: projectDir,
+        encoding: "utf8",
+    });
+    if (r.status !== 0)
+        return new Set();
+    return new Set(r.stdout
+        .split("\n")
+        .map((l) => l.trim().replace(/^harness\//, ""))
+        .filter(Boolean));
+}
+/** Requirements the matrix says are delivered. */
+function implementedRequirements(projectDir) {
+    const file = path.join(projectDir, "docs", "specs", "traceability.md");
+    const done = new Set();
+    if (!fs.existsSync(file))
+        return done;
+    for (const line of fs.readFileSync(file, "utf8").split("\n")) {
+        const cells = line.split("|").map((c) => c.trim());
+        const req = cells.find((c) => /^REQ-\d+$/.test(c));
+        if (req && /^(Implemented|Verified|Released)$/.test(cells[cells.length - 2] || "")) {
+            done.add(req);
+        }
+    }
+    return done;
+}
+/**
+ * Every change, open or archived, with its phase. An archived change keeps its
+ * id after the date prefix the archive gives it (`2026-10-29-alerts`).
+ */
+function boardChanges(projectDir) {
+    const root = path.join(projectDir, CHANGES);
+    if (!fs.existsSync(root))
+        return [];
+    const branches = harnessBranches(projectDir);
+    const implemented = implementedRequirements(projectDir);
+    const out = [];
+    const add = (dir, id, archived) => {
+        const yaml = readYaml(path.join(dir, "change.yaml"));
+        const requirements = deltaRequirements(dir);
+        const building = requirements.some((r) => branches.has(r) || implemented.has(r));
+        const repositories = Array.isArray(yaml.repositories)
+            ? yaml.repositories.map(String).filter(Boolean)
+            : [];
+        out.push({
+            id,
+            dir,
+            archived,
+            ticket: changeTicket(yaml),
+            repositories,
+            requirements,
+            phase: archived ? "archived" : building ? "building" : "proposed",
+        });
+    };
+    for (const e of fs.readdirSync(root, { withFileTypes: true })) {
+        if (!e.isDirectory() || e.name.startsWith("."))
+            continue;
+        if (e.name === "archive") {
+            const archive = path.join(root, "archive");
+            for (const a of fs.readdirSync(archive, { withFileTypes: true })) {
+                if (!a.isDirectory())
+                    continue;
+                add(path.join(archive, a.name), a.name.replace(/^\d{4}-\d{2}-\d{2}-/, ""), true);
+            }
+            continue;
+        }
+        add(path.join(root, e.name), e.name, false);
+    }
+    return out;
+}
+// ── Moving the board ──────────────────────────────────────────────────────────
+/** The state `phases:` names for a phase, or undefined for the provider's default. */
+function namedState(cfg, phase) {
+    const phases = cfg.phases;
+    if (!phases || typeof phases !== "object")
+        return undefined;
+    const value = phases[phase];
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+/** Move one change's ticket to its phase, unless the board was already told. */
+async function movePhase(change, map, client, cfg, opts = {}) {
+    const phase = opts.phase ?? change.phase;
+    const record = (map[change.id] ??= { ticket: change.ticket });
+    record.ticket = change.ticket;
+    const named = namedState(cfg, phase);
+    if (!opts.force && record.phase === phase) {
+        return {
+            change: change.id,
+            action: "in-sync",
+            issue: change.ticket,
+            phase,
+            state: record.state,
+        };
+    }
+    if (!client.capabilities.phase || typeof client.setPhase !== "function") {
+        return {
+            change: change.id,
+            action: "phase-unsupported",
+            issue: change.ticket,
+            phase,
+            detail: `${change.ticket} should be ${phase}, but provider '${cfg.provider}' cannot move an issue — move it by hand.`,
+        };
+    }
+    if (opts.dryRun) {
+        return {
+            change: change.id,
+            action: "would-move",
+            issue: change.ticket,
+            phase,
+            state: named ?? `the ${phase} state`,
+        };
+    }
+    const state = await client.setPhase(change.ticket, phase, named);
+    record.phase = phase;
+    record.state = state;
+    return { change: change.id, action: "moved", issue: change.ticket, phase, state };
+}
+/** REQ-305: every change with a ticket, moved to its phase. */
+async function syncPhases(changes, map, client, cfg, opts = {}) {
+    const actions = [];
+    for (const change of changes) {
+        if (!change.ticket)
+            continue;
+        actions.push(await movePhase({ ...change, ticket: change.ticket }, map, client, cfg, opts));
+    }
+    return actions;
+}
+/** REQ-307: one sub-issue per repository a change names, created once. */
+async function syncSubIssues(changes, map, client, opts = {}) {
+    const actions = [];
+    for (const change of changes) {
+        if (change.archived || change.repositories.length === 0)
+            continue;
+        if (!change.ticket) {
+            actions.push({
+                change: change.id,
+                action: "no-ticket",
+                detail: `${change.id} names repositories but no ticket to hang their sub-issues on — add ticket: <KEY> to its change.yaml.`,
+            });
+            continue;
+        }
+        const record = (map[change.id] ??= { ticket: change.ticket });
+        const children = (record.children ??= {});
+        for (const repo of change.repositories) {
+            if (children[repo])
+                continue;
+            if (!client.capabilities.subIssues || typeof client.createSubIssue !== "function") {
+                actions.push({
+                    change: change.id,
+                    action: "sub-issues-unsupported",
+                    repo,
+                    detail: `${change.ticket} needs a sub-issue for ${repo}, but this provider cannot create one — create it by hand.`,
+                });
+                continue;
+            }
+            if (opts.dryRun) {
+                actions.push({ change: change.id, action: "would-create", repo });
+                continue;
+            }
+            const created = await client.createSubIssue(change.ticket, `${change.ticket} — ${repo}: ${change.id}`);
+            children[repo] = created.key;
+            actions.push({ change: change.id, action: "created", repo, issue: created.key });
+        }
+    }
+    return actions;
+}
+//# sourceMappingURL=phases.js.map

package/dist/scripts/alm/phases.js.map

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

package/dist/scripts/alm/port.js

@@ -33,24 +33,46 @@
  * implementation and its declaration disagree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CORE_CONFIG_KEYS = exports.CAPABILITY_METHOD = exports.CAPABILITIES = void 0;
+exports.CORE_CONFIG_KEYS = exports.CAPABILITY_METHOD = exports.OPTIONAL_CAPABILITIES = exports.CAPABILITIES = exports.PHASES = void 0;
 exports.checkProviderDeclaration = checkProviderDeclaration;
-/** Every capability name, for the checks that iterate them. */
+exports.PHASES = ["proposed", "building", "archived"];
+/** Every capability a provider must declare, for the checks that iterate them. */
 exports.CAPABILITIES = [
     "create",
     "readStatus",
     "close",
     "listIssues",
 ];
+/** The capabilities a provider may declare (REQ-305..307). */
+exports.OPTIONAL_CAPABILITIES = [
+    "phase",
+    "subIssues",
+    "comments",
+    "readText",
+];
 /** The client method each capability promises. */
 exports.CAPABILITY_METHOD = {
     create: "createIssue",
     readStatus: "getIssueStatus",
     close: "closeIssue",
     listIssues: "listIssues",
+    phase: "setPhase",
+    subIssues: "createSubIssue",
+    comments: "listComments",
+    readText: "readIssueText",
 };
-/** Config keys the core itself reads, whatever the provider. */
-exports.CORE_CONFIG_KEYS = ["alm_version", "provider", "pr"];
+/**
+ * Config keys the core itself reads, whatever the provider. `phases` names the
+ * board state of each phase (REQ-305); `mirror: false` keeps `alm sync` from
+ * creating an issue per requirement on a project whose tickets are the source.
+ */
+exports.CORE_CONFIG_KEYS = [
+    "alm_version",
+    "provider",
+    "pr",
+    "phases",
+    "mirror",
+];
 /**
  * Check a provider declaration is well formed.
  *
@@ -107,7 +129,13 @@ function checkCapabilities(candidate) {
             problems.push(`${label}: capability '${capability}' is not declared as a boolean`);
         }
     }
-    const extra = Object.keys(caps).filter((name) => !exports.CAPABILITIES.includes(name));
+    for (const capability of exports.OPTIONAL_CAPABILITIES) {
+        if (capability in caps && typeof caps[capability] !== "boolean") {
+            problems.push(`${label}: capability '${capability}' is not declared as a boolean`);
+        }
+    }
+    const known = [...exports.CAPABILITIES, ...exports.OPTIONAL_CAPABILITIES];
+    const extra = Object.keys(caps).filter((name) => !known.includes(name));
     if (extra.length > 0) {
         problems.push(`${label}: declares unknown capabilit(y/ies): ${extra.join(", ")}`);
     }

package/dist/scripts/alm/port.js.map

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

package/dist/scripts/alm/providers/azure.js

@@ -13,16 +13,7 @@ const API_VERSION = "api-version=7.1";
  * which is why this provider, and only this one, declares `done_state`.
  */
 class AzureClient extends http_client_1.HttpAlmClient {
-    capabilities = {
-        create: true,
-        readStatus: true,
-        close: true,
-        // Azure searches with WIQL — a POST carrying a query language, then a
-        // second request to hydrate each id. That is a different shape from the
-        // other two, and declaring `false` degrades `alm pull` with a message
-        // rather than pretending and failing at the first request.
-        listIssues: false,
-    };
+    capabilities = AZURE_CAPABILITIES;
     authorization;
     projectKey;
     issueType;
@@ -57,6 +48,55 @@ class AzureClient extends http_client_1.HttpAlmClient {
         const state = item.fields?.["System.State"];
         return state !== undefined && DONE_STATES.includes(state) ? "done" : "open";
     }
+    /**
+     * REQ-305: Azure Boards' default process states — New, Active, and the
+     * configured done state — unless `phases:` names the project's own.
+     */
+    async setPhase(issueKey, phase, state) {
+        const target = state ?? (phase === "proposed" ? "New" : phase === "building" ? "Active" : this.doneState);
+        await this.request(`/_apis/wit/workitems/${workItemId(issueKey)}?${API_VERSION}`, `Azure move work item ${issueKey} to ${target}`, {
+            method: "PATCH",
+            headers: this.patchHeaders(),
+            body: JSON.stringify([{ op: "add", path: "/fields/System.State", value: target }]),
+        });
+        return target;
+    }
+    /** REQ-307: a child work item, linked to its parent by the hierarchy relation. */
+    async createSubIssue(parentKey, title) {
+        const created = await this.requestJson(`/${this.projectKey}/_apis/wit/workitems/$${encodeURIComponent(this.issueType)}?${API_VERSION}`, `Azure create child of work item ${parentKey}`, {
+            method: "POST",
+            headers: this.patchHeaders(),
+            body: JSON.stringify([
+                { op: "add", path: "/fields/System.Title", value: title },
+                { op: "add", path: "/fields/System.Tags", value: "spec-driven" },
+                {
+                    op: "add",
+                    path: "/relations/-",
+                    value: {
+                        rel: "System.LinkTypes.Hierarchy-Reverse",
+                        url: `${this.baseUrl}/_apis/wit/workItems/${workItemId(parentKey)}`,
+                    },
+                },
+            ]),
+        });
+        return { key: String(created.id), url: created._links?.html?.href ?? null };
+    }
+    /** REQ-306: the work item's title and description, its HTML flattened. */
+    async readIssueText(issueKey) {
+        const item = await this.requestJson(`/_apis/wit/workitems/${workItemId(issueKey)}?fields=System.Title,System.Description&${API_VERSION}`, `Azure read work item ${issueKey}`, { headers: { Authorization: this.authorization } });
+        const html = String(item.fields?.["System.Description"] ?? "");
+        return {
+            title: String(item.fields?.["System.Title"] ?? ""),
+            body: html
+                .replace(/<br\s*\/?>|<\/(?:p|div|li)>/gi, "\n")
+                .replace(/<[^>]+>/g, "")
+                .replace(/&nbsp;/g, " ")
+                .replace(/&amp;/g, "&")
+                .replace(/&lt;/g, "<")
+                .replace(/&gt;/g, ">")
+                .trim(),
+        };
+    }
     async closeIssue(issueKey) {
         await this.request(`/_apis/wit/workitems/${issueKey}?${API_VERSION}`, `Azure close work item ${issueKey}`, {
             method: "PATCH",
@@ -65,6 +105,27 @@ class AzureClient extends http_client_1.HttpAlmClient {
         });
     }
 }
+/** A work item id as a path segment: digits, nothing a path could be walked with. */
+function workItemId(key) {
+    if (!/^\d+$/.test(key))
+        throw new Error(`Azure: '${key}' is not a work item id.`);
+    return key;
+}
+/** Comments are a preview API on Azure Boards: not read, and `alm pull` says so. */
+const AZURE_CAPABILITIES = {
+    create: true,
+    readStatus: true,
+    close: true,
+    // Azure searches with WIQL — a POST carrying a query language, then a
+    // second request to hydrate each id. That is a different shape from the
+    // other two, and declaring `false` degrades `alm pull` with a message
+    // rather than pretending and failing at the first request.
+    listIssues: false,
+    phase: true,
+    subIssues: true,
+    comments: false,
+    readText: true,
+};
 exports.azureProvider = {
     id: "azure",
     label: "Azure Boards",
@@ -72,7 +133,7 @@ exports.azureProvider = {
         required: ["base_url", "project_key", "token_env"],
         optional: ["issue_type", "done_state"],
     },
-    capabilities: { create: true, readStatus: true, close: true, listIssues: false },
+    capabilities: AZURE_CAPABILITIES,
     create: (cfg, fetchImpl) => new AzureClient(cfg, fetchImpl),
 };
 exports.default = exports.azureProvider;

package/dist/scripts/alm/providers/azure.js.map

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

package/dist/scripts/alm/providers/github.js

@@ -27,12 +27,7 @@ const API_VERSION = "2022-11-28";
  * which is what ADR-0021 asks for.
  */
 class GitHubClient extends http_client_1.HttpAlmClient {
-    capabilities = {
-        create: true,
-        readStatus: true,
-        close: true,
-        listIssues: true,
-    };
+    capabilities = GITHUB_CAPABILITIES;
     headers;
     repo;
     constructor(cfg, fetchImpl) {
@@ -99,6 +94,54 @@ class GitHubClient extends http_client_1.HttpAlmClient {
             url: issue.html_url ?? null,
         }));
     }
+    /**
+     * REQ-305: GitHub has two states, so a phase short of archived is a label —
+     * `specgate:proposed`, `specgate:building`, or the one `phases:` names — and
+     * the other phase's label comes off. Archived closes the issue.
+     */
+    async setPhase(issueKey, phase, state) {
+        const n = issueNumber(issueKey);
+        if (phase === "archived") {
+            await this.closeIssue(n);
+            return "closed";
+        }
+        const label = state ?? `specgate:${phase}`;
+        const other = phase === "proposed" ? "specgate:building" : "specgate:proposed";
+        await this.request(`/repos/${this.repo}/issues/${n}/labels`, `GitHub label issue ${n}`, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify({ labels: [label] }),
+        });
+        // The other phase's label may never have been set: a 404 is the answer
+        // that it is not there, which is what removing it wanted.
+        await this.fetchImpl(`${this.baseUrl}/repos/${this.repo}/issues/${n}/labels/${encodeURIComponent(other)}`, { method: "DELETE", headers: this.headers });
+        return label;
+    }
+    /** REQ-307: a new issue, attached to its parent as a sub-issue. */
+    async createSubIssue(parentKey, title) {
+        const parent = issueNumber(parentKey);
+        const created = await this.requestJson(`/repos/${this.repo}/issues`, `GitHub create a sub-issue of #${parent}`, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify({ title, labels: ["spec-driven"] }),
+        });
+        await this.request(`/repos/${this.repo}/issues/${parent}/sub_issues`, `GitHub attach #${created.number} to #${parent}`, { method: "POST", headers: this.headers, body: JSON.stringify({ sub_issue_id: created.id }) });
+        return { key: String(created.number), url: created.html_url ?? null };
+    }
+    /** REQ-306: the issue's comments, oldest first. */
+    async listComments(issueKey) {
+        const comments = await this.requestJson(`/repos/${this.repo}/issues/${issueNumber(issueKey)}/comments?per_page=100`, `GitHub read the comments of #${issueKey}`, { headers: this.headers });
+        return (comments || []).map((c) => ({
+            id: String(c.id),
+            author: String(c.user?.login ?? ""),
+            body: String(c.body ?? ""),
+        }));
+    }
+    /** REQ-306: the issue's title and body. */
+    async readIssueText(issueKey) {
+        const issue = await this.requestJson(`/repos/${this.repo}/issues/${issueNumber(issueKey)}`, `GitHub read issue #${issueKey}`, { headers: this.headers });
+        return { title: String(issue.title ?? ""), body: String(issue.body ?? "") };
+    }
     async closeIssue(issueKey) {
         await this.request(`/repos/${this.repo}/issues/${issueKey}`, `GitHub close issue ${issueKey}`, {
             method: "PATCH",
@@ -109,6 +152,23 @@ class GitHubClient extends http_client_1.HttpAlmClient {
         });
     }
 }
+/** An issue number as a path segment. */
+function issueNumber(key) {
+    const n = String(key).replace(/^#/, "");
+    if (!/^\d+$/.test(n))
+        throw new Error(`GitHub: '${key}' is not an issue number.`);
+    return n;
+}
+const GITHUB_CAPABILITIES = {
+    create: true,
+    readStatus: true,
+    close: true,
+    listIssues: true,
+    phase: true,
+    subIssues: true,
+    comments: true,
+    readText: true,
+};
 exports.githubProvider = {
     id: "github",
     label: "GitHub Issues",
@@ -117,7 +177,7 @@ exports.githubProvider = {
         // Only GitHub Enterprise Server needs a base URL; github.com is the default.
         optional: ["base_url"],
     },
-    capabilities: { create: true, readStatus: true, close: true, listIssues: true },
+    capabilities: GITHUB_CAPABILITIES,
     create: (cfg, fetchImpl) => new GitHubClient(cfg, fetchImpl),
 };
 exports.default = exports.githubProvider;

package/dist/scripts/alm/providers/github.js.map

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