gsd-pi 2.79.0-dev.ece5fd8ba → 2.80.0-dev.4ea7d80e7

package/dist/resources/.managed-resources-content-hash

@@ -1 +1 @@
-76e1a0d39c0a27d8
+3082d240b707c521

package/dist/resources/extensions/github-sync/templates.js

@@ -1,3 +1,5 @@
+// Project/App: GSD-2
+// File Purpose: Markdown formatters for GitHub sync issues, PR bodies, and comments.
 /**
  * Markdown formatters for GitHub issue bodies, PR descriptions,
  * and summary comments.
@@ -5,6 +7,38 @@
  * All functions produce GitHub-flavored markdown strings ready
  * for the `gh` CLI body parameters.
  */
+import { buildPrEvidence } from "../gsd/pr-evidence.js";
+// ─── Helpers ────────────────────────────────────────────────────────────────
+/**
+ * Wrap a string in a CommonMark inline-code span, escaping any embedded
+ * backticks by selecting a fence longer than the longest backtick run inside
+ * the input. If the input begins or ends with a backtick, pad with a single
+ * space inside the fence (CommonMark requirement).
+ *
+ * Empty input returns an empty string (no fence) — there is nothing to render
+ * as code, and emitting an empty pair of backticks would produce literal
+ * backticks in GitHub-flavored markdown.
+ */
+export function inlineCode(s) {
+    if (s.length === 0)
+        return "";
+    let longestRun = 0;
+    let currentRun = 0;
+    for (const ch of s) {
+        if (ch === "`") {
+            currentRun++;
+            if (currentRun > longestRun)
+                longestRun = currentRun;
+        }
+        else {
+            currentRun = 0;
+        }
+    }
+    const fence = "`".repeat(longestRun + 1);
+    const needsPad = s.startsWith("`") || s.endsWith("`");
+    const pad = needsPad ? " " : "";
+    return `${fence}${pad}${s}${pad}${fence}`;
+}
 export function formatMilestoneIssueBody(data) {
     const lines = [];
     lines.push(`# ${data.id}: ${data.title}`);
@@ -36,37 +70,33 @@ export function formatMilestoneIssueBody(data) {
     return lines.join("\n");
 }
 export function formatSlicePRBody(data) {
-    const lines = [];
-    lines.push(`## ${data.id}: ${data.title}`);
-    lines.push("");
-    if (data.goal) {
-        lines.push("### Goal");
-        lines.push(data.goal);
-        lines.push("");
-    }
-    if (data.mustHaves?.length) {
-        lines.push("### Must-Haves");
-        for (const item of data.mustHaves) {
-            lines.push(`- ${item}`);
-        }
-        lines.push("");
-    }
-    if (data.demoCriterion) {
-        lines.push("### Demo Criterion");
-        lines.push(data.demoCriterion);
-        lines.push("");
-    }
-    if (data.tasks?.length) {
-        lines.push("### Tasks");
-        for (const task of data.tasks) {
-            const ref = task.issueNumber ? ` (#${task.issueNumber})` : "";
-            lines.push(`- [ ] ${task.id}: ${task.title}${ref}`);
-        }
-        lines.push("");
-    }
-    lines.push("---");
-    lines.push("*Auto-generated by GSD GitHub Sync*");
-    return lines.join("\n");
+    const summaries = [
+        data.goal ? `### Goal\n${data.goal}` : "",
+        data.mustHaves?.length ? `### Must-Haves\n${data.mustHaves.map((item) => `- ${item}`).join("\n")}` : "",
+        data.demoCriterion ? `### Demo Criterion\n${data.demoCriterion}` : "",
+        data.tasks?.length
+            ? `### Tasks\n${data.tasks.map((task) => {
+                const ref = task.issueNumber ? ` (#${task.issueNumber})` : "";
+                return `- [ ] ${task.id}: ${task.title}${ref}`;
+            }).join("\n")}`
+            : "",
+    ].filter(Boolean);
+    const issueRefs = (data.tasks ?? [])
+        .map((task) => task.issueNumber)
+        .filter((issueNumber) => typeof issueNumber === "number")
+        .map((issueNumber) => `#${issueNumber}`);
+    return buildPrEvidence({
+        milestoneId: data.id,
+        subjectId: data.id,
+        subjectKind: "slice",
+        milestoneTitle: data.title,
+        changeType: "feat",
+        linkedIssue: issueRefs.length > 0 ? `Related issues: ${issueRefs.join(", ")}` : undefined,
+        summaries,
+        testsRun: data.demoCriterion ? [`Demo criterion: ${data.demoCriterion}`] : undefined,
+        rollbackNotes: ["Close this draft slice PR before merge or revert the slice squash commit from the milestone branch."],
+        how: "Generated by GSD GitHub Sync from the slice plan, task issues, and branch mapping.",
+    }).body;
 }
 export function formatTaskIssueBody(data) {
     const lines = [];
@@ -79,7 +109,7 @@ export function formatTaskIssueBody(data) {
     if (data.files?.length) {
         lines.push("### Files");
         for (const file of data.files) {
-            lines.push(`- \`${file}\``);
+            lines.push(`- ${inlineCode(file)}`);
         }
         lines.push("");
     }
@@ -129,52 +159,38 @@ function checkedList(items, emptyLabel) {
     return items.map((item) => `- [ ] ${item}`);
 }
 export function formatSwarmLanePRBody(data) {
-    const lines = [];
     const laneLabel = SWARM_LANE_LABELS[data.lane.id];
-    lines.push("## Swarm lane");
-    lines.push("");
-    lines.push(`**Lane:** \`${laneLabel}\``);
-    lines.push(`**Branch:** \`${data.lane.branch}\``);
-    if (data.lane.owner)
-        lines.push(`**Owner:** ${data.lane.owner}`);
-    if (data.lane.latestCommit)
-        lines.push(`**Latest commit:** \`${data.lane.latestCommit}\``);
-    lines.push("");
-    lines.push("## Impact area");
-    lines.push("");
-    lines.push(data.impactArea);
-    lines.push("");
-    lines.push("## Changed contracts");
-    lines.push(...checkedList(data.lane.changedContracts, "No shared contracts changed"));
-    lines.push("");
-    lines.push("## Transition risks");
-    lines.push(...checkedList(data.transitionRisks, "No transition risks identified"));
-    lines.push("");
-    lines.push("## Rollback plan");
-    lines.push(...checkedList(data.rollbackPlan, "Revert this lane PR"));
-    lines.push("");
-    lines.push("## Test evidence");
-    lines.push(...checkedList(data.lane.testEvidence, "Test evidence pending"));
-    lines.push("");
-    if (data.lane.blockers?.length) {
-        lines.push("## Blockers");
-        for (const blocker of data.lane.blockers)
-            lines.push(`- ${blocker}`);
-        lines.push("");
-    }
-    if (data.linkedIssue) {
-        lines.push(`Closes #${data.linkedIssue}`);
-        lines.push("");
-    }
-    lines.push("---");
-    lines.push("*Auto-generated by GSD GitHub Sync swarm routines*");
-    return lines.join("\n");
+    const summaries = [
+        [
+            "### Swarm lane",
+            `**Lane:** ${inlineCode(laneLabel)}`,
+            `**Branch:** ${inlineCode(data.lane.branch)}`,
+            data.lane.owner ? `**Owner:** ${data.lane.owner}` : "",
+            data.lane.latestCommit ? `**Latest commit:** ${inlineCode(data.lane.latestCommit)}` : "",
+        ].filter(Boolean).join("\n"),
+        `### Impact area\n${data.impactArea}`,
+        `### Changed contracts\n${checkedList(data.lane.changedContracts, "No shared contracts changed").join("\n")}`,
+        `### Transition risks\n${checkedList(data.transitionRisks, "No transition risks identified").join("\n")}`,
+    ].filter(Boolean);
+    return buildPrEvidence({
+        milestoneId: laneLabel,
+        subjectId: laneLabel,
+        subjectKind: "workflow",
+        milestoneTitle: laneLabel,
+        changeType: "refactor",
+        linkedIssue: data.linkedIssue ? `Closes #${data.linkedIssue}` : undefined,
+        summaries,
+        blockers: data.lane.blockers ?? [],
+        testsRun: data.lane.testEvidence,
+        rollbackNotes: data.rollbackPlan,
+        how: "Generated by GSD GitHub Sync swarm routines from lane evidence.",
+    }).body;
 }
 export function formatSwarmReleaseChecklistBody(data) {
     const lines = [];
     lines.push(`# UOK Swarm Release Checklist`);
     lines.push("");
-    lines.push(`**Integration branch:** \`${data.integrationBranch}\``);
+    lines.push(`**Integration branch:** ${inlineCode(data.integrationBranch)}`);
     lines.push("");
     lines.push("## Lane summary");
     lines.push("");
@@ -182,9 +198,9 @@ export function formatSwarmReleaseChecklistBody(data) {
     lines.push("|------|--------|-------|--------|--------|");
     for (const lane of data.lanes) {
         const owner = lane.owner ?? "";
-        const commit = lane.latestCommit ? `\`${lane.latestCommit}\`` : "";
+        const commit = lane.latestCommit ? inlineCode(lane.latestCommit) : "";
         const status = lane.blockers?.length ? "blocked" : "ready";
-        lines.push(`| \`${SWARM_LANE_LABELS[lane.id]}\` | \`${lane.branch}\` | ${owner} | ${commit} | ${status} |`);
+        lines.push(`| ${inlineCode(SWARM_LANE_LABELS[lane.id])} | ${inlineCode(lane.branch)} | ${owner} | ${commit} | ${status} |`);
     }
     lines.push("");
     lines.push("## Required evidence");

package/dist/resources/extensions/gsd/auto/contracts.js

@@ -0,0 +1 @@
+export {};

package/dist/resources/extensions/gsd/auto/custom-verify-retry-store.js

@@ -0,0 +1,53 @@
+// Project/App: GSD-2
+// File Purpose: Persistence adapter for custom workflow verification retry counts.
+import { readFileSync, mkdirSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import { atomicWriteSync } from "../atomic-write.js";
+import { gsdRoot } from "../paths.js";
+export function customVerifyRetryStateDir(s) {
+    return s.activeRunDir ? join(s.activeRunDir, "runtime") : join(gsdRoot(s.basePath), "runtime");
+}
+export function customVerifyRetryStatePath(s) {
+    return join(customVerifyRetryStateDir(s), "custom-verify-retries.json");
+}
+export function hydrateCustomVerifyRetryCounts(s, deps) {
+    if (s.verificationRetryCount.size > 0) {
+        return s.verificationRetryCount;
+    }
+    try {
+        const raw = JSON.parse(readFileSync(customVerifyRetryStatePath(s), "utf-8"));
+        const counts = raw && typeof raw === "object" && raw.counts && typeof raw.counts === "object"
+            ? raw.counts
+            : {};
+        for (const [key, value] of Object.entries(counts)) {
+            if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+                s.verificationRetryCount.set(key, Math.floor(value));
+            }
+        }
+    }
+    catch (err) {
+        deps.logFailure(err);
+    }
+    return s.verificationRetryCount;
+}
+export function saveCustomVerifyRetryCounts(s, deps) {
+    const retryCounts = s.verificationRetryCount;
+    const filePath = customVerifyRetryStatePath(s);
+    try {
+        if (!retryCounts || retryCounts.size === 0) {
+            unlinkSync(filePath);
+            return;
+        }
+        mkdirSync(customVerifyRetryStateDir(s), { recursive: true });
+        atomicWriteSync(filePath, JSON.stringify({
+            counts: Object.fromEntries(retryCounts),
+            updatedAt: new Date().toISOString(),
+        }) + "\n");
+    }
+    catch (err) {
+        const code = err && typeof err === "object" && "code" in err ? err.code : undefined;
+        if (code !== "ENOENT") {
+            deps.logFailure(err);
+        }
+    }
+}