@crewbie/cli 0.1.0-alpha.49

package/dist/tracking/refs.js

@@ -0,0 +1,56 @@
+import { GitHubError, record, string } from "../core.js";
+/**
+ * Crewbie's ledger refs (claims, launches, pause, dispatch lock) live under refs/crewbie/, outside refs/heads and
+ * refs/tags, so creating them never fires a repository's `on: push` workflows. Releases before 0.1.0-alpha.44 wrote
+ * them as tags; those legacy refs are still read so existing claims and launch allowances keep counting.
+ */
+const ROOT = "crewbie";
+const LEGACY = "tags/crewbie";
+/** Full ref for a ledger entry, e.g. ledgerRef("claims/3") === "refs/crewbie/claims/3". */
+export function ledgerRef(name) { return `refs/${ROOT}/${name}`; }
+export async function listLedger(client, repository, prefix) {
+    const entries = [];
+    for (const root of [ROOT, LEGACY]) {
+        const refs = await client.request("GET", `/repos/${repository}/git/matching-refs/${root}/${prefix}`);
+        if (!Array.isArray(refs))
+            throw new Error("GitHub returned an invalid Crewbie ref ledger.");
+        for (const raw of refs) {
+            const item = record(raw, "ledger ref");
+            const ref = string(item.ref, "ledger ref name");
+            if (!ref.startsWith(`refs/${root}/${prefix}`))
+                throw new Error(`Unexpected Crewbie ledger ref: ${ref}`);
+            entries.push({ name: ref.slice(`refs/${root}/`.length), ref, ...(item.object === undefined ? {} : { object: record(item.object, "ledger ref object") }) });
+        }
+    }
+    return entries;
+}
+export async function ledgerHas(client, repository, name) {
+    for (const root of [ROOT, LEGACY]) {
+        try {
+            await client.request("GET", `/repos/${repository}/git/ref/${root}/${name}`);
+            return true;
+        }
+        catch (error) {
+            if (!(error instanceof GitHubError && error.status === 404))
+                throw error;
+        }
+    }
+    return false;
+}
+/** Atomically creates a ledger ref; GitHub answers 422 when it already exists. */
+export async function createLedger(client, repository, name, sha) {
+    await client.request("POST", `/repos/${repository}/git/refs`, { ref: ledgerRef(name), sha });
+}
+/** Deletes the ledger ref; with legacy, deletes whichever of the current and legacy refs exist. */
+export async function deleteLedger(client, repository, name, legacy = false) {
+    for (const root of legacy ? [ROOT, LEGACY] : [ROOT]) {
+        try {
+            await client.request("DELETE", `/repos/${repository}/git/refs/${root}/${name}`);
+        }
+        catch (error) {
+            if (!legacy || !(error instanceof GitHubError && [404, 422].includes(error.status)))
+                throw error;
+        }
+    }
+}
+//# sourceMappingURL=refs.js.map

package/dist/tracking/refs.js.map

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

package/dist/tracking/sources.d.ts

@@ -0,0 +1,5 @@
+import type { Config } from "../config.js";
+import type { SourceReference } from "../specification/batch.js";
+import type { GitHubApi } from "./github.js";
+import { type AdoApi } from "./ado.js";
+export declare function verifySources(sources: SourceReference[], github: GitHubApi, config: Config, ado?: AdoApi): Promise<void>;

package/dist/tracking/sources.js

@@ -0,0 +1,29 @@
+import { hash, integer, record, string } from "../core.js";
+import { importWorkItem } from "./ado.js";
+export async function verifySources(sources, github, config, ado) {
+    for (const source of sources) {
+        const gh = /^https:\/\/github\.com\/([A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+)\/issues\/(\d+)$/.exec(source.uri);
+        if (gh) {
+            const issue = record(await github.request("GET", `/repos/${gh[1]}/issues/${gh[2]}`), "source issue");
+            const content = `${string(issue.title, "source title")}\n\n${typeof issue.body === "string" ? issue.body : ""}`;
+            const matches = source.fingerprint ? source.fingerprint === hash(content) : source.revision === issue.updated_at;
+            if (!matches)
+                throw new Error(`Source changed: ${source.uri}. Reconcile and approve the batch again.`);
+        }
+        else if (source.uri.startsWith("https://dev.azure.com/")) {
+            if (!config.ado || !ado)
+                throw new Error("ADO source verification requires the configured integration and credential.");
+            const url = new URL(source.uri);
+            const parts = url.pathname.split("/").filter(Boolean).map(decodeURIComponent);
+            if (parts.length !== 5 || parts[0] !== config.ado.organization || parts[1] !== config.ado.project || parts[2] !== "_workitems" || parts[3] !== "edit") {
+                throw new Error("ADO source must match the configured organization and project.");
+            }
+            const current = await importWorkItem(ado, config.ado, integer(Number(parts[4]), "source work item"));
+            const matches = source.fingerprint ? current.fingerprint === source.fingerprint : current.revision === source.revision;
+            if (!matches)
+                throw new Error(`ADO requirements changed: ${source.uri}. Reconcile and reapprove; no source fields were overwritten.`);
+        }
+        // Other inputs are approved text snapshots, not continuously synchronized trackers.
+    }
+}
+//# sourceMappingURL=sources.js.map

package/dist/tracking/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../../src/tracking/sources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAI3D,OAAO,EAAE,cAAc,EAAe,MAAM,UAAU,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAA0B,EAAE,MAAiB,EAAE,MAAc,EAAE,GAAY;IAC7G,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,4EAA4E,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzG,IAAI,EAAE,EAAE,CAAC;YACP,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,cAAc,CAAC,CAAC;YACrG,MAAM,OAAO,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAChH,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,UAAU,CAAC;YACjH,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,GAAG,0CAA0C,CAAC,CAAC;QACzG,CAAC;aAAM,IAAI,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,wBAAwB,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;YACxH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAC9E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,YAAY,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,YAAY,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;gBACtJ,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;YACpF,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC;YACrG,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,KAAK,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC;YACvH,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,GAAG,+DAA+D,CAAC,CAAC;QACxI,CAAC;QACD,oFAAoF;IACtF,CAAC;AACH,CAAC"}