@theholocron/cli 2.0.0-alpha.12 → 2.0.0-alpha.14

package/dist/cli.mjs

@@ -1361,8 +1361,10 @@ name: Sync GitHub Templates
 # template source files change on main or alpha.
 #
 # Secrets required:
-#   SYNC_TOKEN — fine-grained PAT or GitHub App token with Contents write
-#                access to the primary and secondary repos.
+#   SYNC_TOKEN — fine-grained PAT (resource owner: org) with:
+#                  Contents:      Read and write  (git trees, blobs, refs)
+#                  Pull requests: Read and write  (open sync PR)
+#                  Workflows:     Read and write  (write .github/workflows/*.yml)
 
 on: # yamllint disable-line rule:truthy
   workflow_call:
@@ -1839,7 +1841,8 @@ async function runSyncGithub(input) {
 		};
 	}
 	let targetBranch = branch;
-	if (!targetBranch) {
+	let defaultBranch;
+	if (!targetBranch || createPr) {
 		const repoRes = await fetchFn(`${API_BASE}/repos/${owner}/${repoName}`, { headers });
 		if (!repoRes.ok) {
 			const msg = "failed to fetch repo metadata";
@@ -1852,11 +1855,13 @@ async function runSyncGithub(input) {
 				message: msg
 			};
 		}
-		targetBranch = (await repoRes.json()).default_branch;
+		defaultBranch = (await repoRes.json()).default_branch;
+		if (!targetBranch) targetBranch = defaultBranch;
 	}
-	const refRes = await fetchFn(`${API_BASE}/repos/${owner}/${repoName}/git/ref/heads/${targetBranch}`, { headers });
+	const baseBranch = createPr && defaultBranch ? defaultBranch : targetBranch;
+	const refRes = await fetchFn(`${API_BASE}/repos/${owner}/${repoName}/git/ref/heads/${baseBranch}`, { headers });
 	if (!refRes.ok) {
-		const msg = `Branch ${targetBranch} not found`;
+		const msg = `Branch ${baseBranch} not found`;
 		print(`  ✗ ${msg}`);
 		return {
 			status: "fail",
@@ -1979,13 +1984,31 @@ async function runSyncGithub(input) {
 		};
 	}
 	const { sha: newCommitSha } = await newCommitRes.json();
-	const updateRefRes = await fetchFn(`${API_BASE}/repos/${owner}/${repoName}/git/refs/heads/${targetBranch}`, {
+	let refUpdateRes;
+	if (createPr && branch) {
+		refUpdateRes = await fetchFn(`${API_BASE}/repos/${owner}/${repoName}/git/refs`, {
+			method: "POST",
+			headers,
+			body: JSON.stringify({
+				ref: `refs/heads/${branch}`,
+				sha: newCommitSha
+			})
+		});
+		if (refUpdateRes.status === 422) refUpdateRes = await fetchFn(`${API_BASE}/repos/${owner}/${repoName}/git/refs/heads/${branch}`, {
+			method: "PATCH",
+			headers,
+			body: JSON.stringify({
+				sha: newCommitSha,
+				force: true
+			})
+		});
+	} else refUpdateRes = await fetchFn(`${API_BASE}/repos/${owner}/${repoName}/git/refs/heads/${targetBranch}`, {
 		method: "PATCH",
 		headers,
 		body: JSON.stringify({ sha: newCommitSha })
 	});
-	if (!updateRefRes.ok) {
-		const msg = `failed to update ref: ${(await updateRefRes.json()).message ?? updateRefRes.status}`;
+	if (!refUpdateRes.ok) {
+		const msg = `failed to update ref: ${(await refUpdateRes.json()).message ?? refUpdateRes.status}`;
 		print(`  ✗ ${msg}`);
 		return {
 			status: "fail",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/cli",
-  "version": "2.0.0-alpha.12",
+  "version": "2.0.0-alpha.14",
   "description": "The Holocron CLI — a pluggable, capability-based orchestrator for spinning up and operating software projects.",
   "homepage": "https://github.com/theholocron/holocron/tree/main/packages/cli#readme",
   "bugs": "https://github.com/theholocron/holocron/issues",