@1aboveio/skills 0.10.0

package/skills/engineering/resolve-release/scripts/metadata-pr-status.mjs

@@ -0,0 +1,56 @@
+// Metadata-PR status helper: acyclic home for the source tag and the completeness
+// check used by both report.mjs and postmortem.mjs. Keeping them here breaks the
+// import cycle that formed when postmortem.mjs imported report.mjs for this one
+// function (report.mjs dynamically imports postmortem.mjs at its top level).
+
+// Only metadata-sync.mjs may record a complete metadataPr entry. The source tag is
+// what stops a hand-rolled release.metadataSync or hand-written metadataPr from
+// satisfying the gate (skyee v0.5.0 regression).
+export const METADATA_SYNC_SOURCE = 'metadata-sync.mjs'
+
+// Metadata-PR completeness for a released attempt (verified-sha-github-flow post-release
+// adapter). Only metadata-sync.mjs open|na|migrate may record a complete entry.
+export function metadataPrStatus(release) {
+  const r = release || {}
+  const attempt = r.attempt || {}
+  if (attempt.state !== 'released') return null
+
+  // A legacy hand-written record must not pass on its own. It is called out so the operator
+  // can run `metadata-sync.mjs migrate` if migration is appropriate.
+  const legacy = r.metadataSync
+  const legacyNote = legacy && typeof legacy === 'object'
+    ? ' — legacy `metadataSync` is present but not accepted; use `metadata-sync.mjs migrate`'
+    : ''
+
+  const meta = r.metadataPr
+  if (!meta || typeof meta !== 'object') {
+    return {
+      complete: false,
+      line: `metadata PR: **owed** — released without a recorded metadata PR (open one, or record \`n/a\` with a reason)${legacyNote}`,
+    }
+  }
+  if (meta.source !== METADATA_SYNC_SOURCE) {
+    return {
+      complete: false,
+      line: `metadata PR: **owed** — recorded entry has source ${JSON.stringify(meta.source)}; only ${METADATA_SYNC_SOURCE} may record completion${legacyNote}`,
+    }
+  }
+  if (meta.status === 'n/a') {
+    if (!meta.reason || !String(meta.reason).trim()) {
+      return { complete: false, line: 'metadata PR: **owed** — `n/a` without a reason is incomplete' }
+    }
+    return { complete: true, line: `metadata PR: n/a — ${meta.reason}` }
+  }
+  if (meta.status === 'opened' || meta.status === 'merged') {
+    if (meta.number == null && !meta.url) {
+      return { complete: false, line: `metadata PR: **owed** — ${meta.status} with no number or URL is incomplete` }
+    }
+    const ref = meta.number != null ? `#${meta.number}` : meta.url
+    const url = meta.url ? ` (${meta.url})` : ''
+    return { complete: true, line: `metadata PR: ${ref}${url}` }
+  }
+  if (meta.status === 'planned') {
+    return { complete: false, line: 'metadata PR: **owed** — status is `planned`; a planned PR is not yet opened' }
+  }
+  return { complete: false, line: `metadata PR: **owed** — recorded entry has status ${JSON.stringify(meta.status)} and is not complete${legacyNote}` }
+}