@theholocron/cli 3.49.0 → 3.50.0

package/dist/cli.mjs

@@ -4895,8 +4895,8 @@ function deriveBasepath(domain, repoName) {
 	}
 	return repoName;
 }
-function titleCase(s) {
-	return s.charAt(0).toUpperCase() + s.slice(1);
+function toNavLabel(basepath) {
+	return basepath.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
 }
 function extractFromJson(raw, repoName) {
 	let config;
@@ -4909,40 +4909,31 @@ function extractFromJson(raw, repoName) {
 	if (!providers?.wiki) return null;
 	const wikiEntry = providers.wiki;
 	let domain;
-	let subtitle;
-	let icon;
 	if (Array.isArray(wikiEntry) && wikiEntry.length === 2) {
 		const opts = wikiEntry[1];
 		domain = typeof opts.domain === "string" ? opts.domain : void 0;
-		subtitle = typeof opts.subtitle === "string" ? opts.subtitle : void 0;
-		icon = typeof opts.icon === "string" ? opts.icon : void 0;
 	}
-	if (!subtitle && typeof config.description === "string") subtitle = config.description;
 	const basepath = deriveBasepath(domain, repoName);
 	return {
-		displayName: titleCase(basepath),
+		displayName: toNavLabel(basepath),
 		basepath,
-		...subtitle ? { subtitle } : {},
-		...icon ? { icon } : {}
+		...domain ? { domain } : {}
 	};
 }
 function extractFromTs(raw, repoName) {
 	const hasWikiProvider = /providers\s*:\s*\{[^}]*\bwiki\b/s.test(raw);
 	const hasWikiPreset = /\bwikiCapability\b|\bwiki\s*\(\s*\)/.test(raw);
+	/* c8 ignore next */
 	if (!hasWikiProvider && !hasWikiPreset) return null;
 	const domain = raw.match(/\bdomain\s*:\s*["']([^"']+)["']/)?.[1];
-	let subtitle = raw.match(/\bsubtitle\s*:\s*["']([^"']+)["']/)?.[1];
-	const icon = raw.match(/\bicon\s*:\s*["']([^"']+)["']/)?.[1];
-	if (!subtitle) subtitle = raw.match(/\bdescription\s*:\s*["']([^"']+)["']/)?.[1];
 	const basepath = deriveBasepath(domain, repoName);
 	return {
-		displayName: titleCase(basepath),
+		displayName: toNavLabel(basepath),
 		basepath,
-		...subtitle ? { subtitle } : {},
-		...icon ? { icon } : {}
+		...domain ? { domain } : {}
 	};
 }
-async function discoverWikiProducts(org, token, fetchFn) {
+async function discoverWikiRepos(org, token, fetchFn) {
 	const rest = createRestClient({
 		baseUrl: "https://api.github.com",
 		token,
@@ -4965,52 +4956,81 @@ async function discoverWikiProducts(org, token, fetchFn) {
 		if (batch.length < 100) break;
 		page++;
 	}
-	const products = [];
+	const repos = [];
 	for (const repo of allRepos.filter((r) => !r.archived)) {
-		let product = null;
+		let found = null;
 		try {
 			const contents = await rest.request(`/repos/${repo.full_name}/contents/holocron.config.json`);
-			if (contents.encoding === "base64") product = extractFromJson(Buffer.from(contents.content.replace(/\s/g, ""), "base64").toString("utf8"), repo.name);
+			if (contents.encoding === "base64") found = extractFromJson(Buffer.from(contents.content.replace(/\s/g, ""), "base64").toString("utf8"), repo.name);
 		} catch {}
-		if (!product) try {
+		if (!found) try {
 			const contents = await rest.request(`/repos/${repo.full_name}/contents/holocron.config.ts`);
-			if (contents.encoding === "base64") product = extractFromTs(Buffer.from(contents.content.replace(/\s/g, ""), "base64").toString("utf8"), repo.name);
+			if (contents.encoding === "base64") found = extractFromTs(Buffer.from(contents.content.replace(/\s/g, ""), "base64").toString("utf8"), repo.name);
 		} catch {}
-		if (product) products.push(product);
+		if (found) repos.push(found);
 	}
-	products.sort((a, b) => a.basepath.localeCompare(b.basepath));
-	return products;
+	repos.sort((a, b) => a.basepath.localeCompare(b.basepath));
+	return repos;
 }
-function buildProductsBlock(products) {
-	const lines = ["products:"];
-	for (const p of products) {
-		lines.push(`  - display-name: ${p.displayName}`);
-		if (p.subtitle) lines.push(`    subtitle: ${p.subtitle}`);
-		if (p.icon) lines.push(`    icon: ${p.icon}`);
-		lines.push(`    href: /${p.basepath}`);
+/**
+* Builds the complete navbar-links YAML block for a given repo.
+*
+* Includes:
+*  - A GitHub button linking to the repo itself (always first)
+*  - Minimal nav links to every other wiki-enabled repo (excluding self)
+*
+* The block is replaced wholesale on each sync so removed wikis disappear
+* and new ones appear automatically.
+*/
+function buildNavbarLinks(repos, currentBasepath, repoFullName) {
+	const lines = [
+		`navbar-links:`,
+		`  - type: github`,
+		`    value: https://github.com/${repoFullName}`
+	];
+	for (const repo of repos) {
+		if (repo.basepath === currentBasepath) continue;
+		const url = repo.domain ? `https://${repo.domain}` : `https://wiki.theholocron.dev/${repo.basepath}`;
+		lines.push(`  - type: minimal`, `    value: ${url}`, `    label: ${repo.displayName}`);
 	}
 	return lines.join("\n");
 }
-async function mergeProducts(docsYmlPath, products) {
+/**
+* Idempotently ensures `edit-this-page:` (inside instances) is present and
+* replaces `navbar-links:` with the provided shared block.
+*
+* Returns true when the file was modified.
+* Throws when fern/docs.yml does not exist.
+*/
+async function mergeWikiConfig(docsYmlPath, config) {
 	let content;
 	try {
 		content = await readFile(docsYmlPath, "utf8");
 	} catch {
 		throw new Error(`fern/docs.yml not found at ${docsYmlPath}`);
 	}
-	const newBlock = buildProductsBlock(products);
-	const productBlockRe = /^products:(?:\n[ \t][^\n]*)*/m;
-	if (productBlockRe.test(content)) {
-		const updated = content.replace(productBlockRe, newBlock);
-		if (updated !== content) await writeFile(docsYmlPath, updated, "utf8");
-		return;
-	}
-	const instancesIdx = content.indexOf("\ninstances:");
-	if (instancesIdx !== -1) {
-		await writeFile(docsYmlPath, content.slice(0, instancesIdx + 1) + newBlock + "\n\n" + content.slice(instancesIdx + 1), "utf8");
-		return;
+	let updated = content;
+	if (!updated.includes("edit-this-page:")) {
+		const editBlock = [
+			`    edit-this-page:`,
+			`      github:`,
+			`        owner: ${config.owner}`,
+			`        repo: ${config.repoName}`,
+			`        branch: main`
+		].join("\n");
+		if (/^ {4}multi-source: true$/m.test(updated)) updated = updated.replace(/^( {4}multi-source: true)$/m, `$1\n${editBlock}`);
+		else if (/^ {4}custom-domain: .+$/m.test(updated)) updated = updated.replace(/^( {4}custom-domain: .+)$/m, `$1\n${editBlock}`);
+		else updated = updated.replace(/^( {2}- url: .+)$/m, `$1\n${editBlock}`);
+	}
+	const navbarRe = /^navbar-links:(?:\n[ \t][^\n]*)*/m;
+	if (navbarRe.test(updated)) updated = updated.replace(navbarRe, config.navbarBlock);
+	else if (/^colors:/m.test(updated)) updated = updated.replace(/^(colors:)/m, `${config.navbarBlock}\n\n$1`);
+	else updated = updated.trimEnd() + "\n\n" + config.navbarBlock + "\n";
+	if (updated !== content) {
+		await writeFile(docsYmlPath, updated, "utf8");
+		return true;
 	}
-	await writeFile(docsYmlPath, content.trimEnd() + "\n\n" + newBlock + "\n", "utf8");
+	return false;
 }
 async function runSyncWiki(input) {
 	const config = input.loaded.resolved;
@@ -5021,13 +5041,21 @@ async function runSyncWiki(input) {
 		status: "skip",
 		message: "no wiki provider configured"
 	};
-	const org = config.org ?? input.context.repo?.split("/")[0];
-	if (!org) return {
+	const rawRepo = input.context.repo ?? config.repo?.name;
+	if (!rawRepo) return {
+		capability: "local",
+		step: "sync wiki",
+		status: "skip",
+		message: "no repo configured"
+	};
+	const [owner, repoName] = rawRepo.split("/");
+	if (!owner || !repoName) return {
 		capability: "local",
 		step: "sync wiki",
 		status: "skip",
-		message: "no org configured"
+		message: "repo must be owner/name format"
 	};
+	const org = config.org ?? owner;
 	const token = resolveToken(input);
 	if (!token) return {
 		capability: "local",
@@ -5042,26 +5070,24 @@ async function runSyncWiki(input) {
 	};
 	const docsYmlPath = join(input.context.repoRoot, "fern", "docs.yml");
 	try {
-		const products = await discoverWikiProducts(org, token, input.fetch);
-		if (products.length === 0) return {
-			capability: "local",
-			step: "sync wiki",
-			status: "skip",
-			message: "no wiki-enabled repos found"
-		};
-		await mergeProducts(docsYmlPath, products);
+		const repos = await discoverWikiRepos(org, token, input.fetch);
+		const wikiOpts = config.providers.wiki?.tuple?.options;
 		return {
 			capability: "local",
 			step: "sync wiki",
 			status: "ok",
-			message: `${products.length} products`
+			message: await mergeWikiConfig(docsYmlPath, {
+				owner,
+				repoName,
+				navbarBlock: buildNavbarLinks(repos, deriveBasepath(typeof wikiOpts?.domain === "string" ? wikiOpts.domain : void 0, repoName), rawRepo)
+			}) ? `updated (${repos.length} wiki repos discovered)` : "already up to date"
 		};
 	} catch (err) {
 		return {
 			capability: "local",
 			step: "sync wiki",
 			status: "fail",
-			message: err instanceof Error ? err.message : String(err)
+			message: err instanceof Error ? err.message : 			/* c8 ignore next */ String(err)
 		};
 	}
 }
@@ -5509,7 +5535,7 @@ var security_default = "name: Security\n\non: # yamllint disable-line rule:truth
 var stale_default = "name: Stale\n\non: # yamllint disable-line rule:truthy\n  workflow_call:\n    inputs:\n      days-before-stale:\n        description: Days of inactivity before an issue is marked stale\n        type: number\n        required: false\n        default: 30\n      days-before-close:\n        description: Days of inactivity after stale label before closing\n        type: number\n        required: false\n        default: 5\n\njobs:\n  stale:\n    name: Mark stale issues and pull requests\n    permissions:\n      contents: write\n      issues: write\n      pull-requests: write\n    runs-on: ubuntu-latest\n    timeout-minutes: 10\n    steps:\n      - uses: actions/stale@1e223db275d687790206a7acac4d1a11bd6fe629 # v10.4.0\n        name: Run Stale\n        with:\n          close-issue-message: >\n            This issue was closed because it has been stalled for\n            ${{ inputs.days-before-close }} days with no activity.\n          days-before-close: ${{ inputs.days-before-close }}\n          days-before-stale: ${{ inputs.days-before-stale }}\n          exempt-all-pr-milestones: true\n          stale-issue-label: wontfix\n          stale-issue-message: >\n            This issue is stale because it has been open ${{ inputs.days-before-stale }}\n            days with no activity. Remove the stale label or comment, or this will be\n            closed in ${{ inputs.days-before-close }} days.\n          stale-pr-label: wontfix\n          stale-pr-message: >\n            This PR is stale because it has been open ${{ inputs.days-before-stale }}\n            days with no activity. Remove the stale label or comment, or this will be\n            closed in ${{ inputs.days-before-close }} days.\n";
 //#endregion
 //#region src/templates/workflows/sync.yml
-var sync_default = "name: Sync\n\non: # yamllint disable-line rule:truthy\n  workflow_call:\n    inputs:\n      steps:\n        description: >\n          Sync steps to run (default: all). Valid values:\n          labels, properties, teams, topics, keywords, description, homepage, readme, workflows.\n          Pass a space-separated list to run a subset, e.g. \"readme\" or \"readme description\".\n        type: string\n        required: false\n    secrets:\n      HOLOCRON_ADMIN_TOKEN:\n        description: Fine-grained PAT with admin scopes (labels, properties, teams).\n        required: false\n      HOLOCRON_DEPLOY_TOKEN:\n        description: Fine-grained PAT for GitHub Pages configuration.\n        required: false\n      HOLOCRON_ISSUES_TOKEN:\n        description: Fine-grained PAT for issue management.\n        required: false\n      HOLOCRON_ORG_TOKEN:\n        description: Org-scoped fine-grained PAT for team sync and org properties.\n        required: false\n      HOLOCRON_READ_TOKEN:\n        description: Fine-grained PAT for read-only GitHub API calls.\n        required: false\n      HOLOCRON_SYNC_TOKEN:\n        required: false\n      GH_TOKEN:\n        description: >\n          Generic GitHub token fallback for gh CLI calls. Used when\n          HOLOCRON_SYNC_TOKEN is not set.\n        required: false\n\njobs:\n  sync:\n    name: Sync repo from config\n    runs-on: ubuntu-latest\n    timeout-minutes: 10\n    permissions:\n      contents: write\n      pull-requests: write\n    steps:\n      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0\n        name: Checkout repository\n        with:\n          token: ${{ secrets.HOLOCRON_SYNC_TOKEN || secrets.GH_TOKEN || github.token }}\n\n      - uses: theholocron/.github/.github/actions/setup@main\n        name: Setup\n\n      - name: Run holocron sync\n        run: |\n          if [ -n \"$STEPS\" ]; then\n            # shellcheck disable=SC2086\n            pnpm --workspace-root exec holocron sync --steps $STEPS\n          else\n            pnpm --workspace-root exec holocron sync\n          fi\n        env:\n          HOLOCRON_ADMIN_TOKEN: ${{ secrets.HOLOCRON_ADMIN_TOKEN }}\n          HOLOCRON_DEPLOY_TOKEN: ${{ secrets.HOLOCRON_DEPLOY_TOKEN }}\n          HOLOCRON_ISSUES_TOKEN: ${{ secrets.HOLOCRON_ISSUES_TOKEN }}\n          HOLOCRON_ORG_TOKEN: ${{ secrets.HOLOCRON_ORG_TOKEN }}\n          HOLOCRON_READ_TOKEN: ${{ secrets.HOLOCRON_READ_TOKEN }}\n          HOLOCRON_SYNC_TOKEN: ${{ secrets.HOLOCRON_SYNC_TOKEN }}\n          STEPS: ${{ inputs.steps }}\n\n      - name: Format generated files\n        run: pnpm exec prettier --write README.md docs/src/content/docs/index.mdx 2>/dev/null || true\n\n      - uses: theholocron/.github/.github/actions/auto-commit@main\n        id: auto-commit\n        name: Commit sync changes\n        with:\n          token: ${{ secrets.HOLOCRON_SYNC_TOKEN || secrets.GH_TOKEN || github.token }}\n          branch: chore/auto-sync\n          commit-message: \"chore: sync from holocron.config\"\n          commit-options: \"--no-verify\"\n\n      - name: Open PR if changes were committed\n        if: steps.auto-commit.outputs.changes-detected == 'true'\n        run: |\n          gh pr create \\\n            --title \"chore: sync README and repo metadata\" \\\n            --body \"Automated sync triggered by changes to config or package files. Merge to apply.\" \\\n            --base main \\\n            --head chore/auto-sync \\\n          || echo \"PR already open — branch updated.\"\n        env:\n          GH_TOKEN: ${{ secrets.HOLOCRON_SYNC_TOKEN || secrets.GH_TOKEN || github.token }}\n";
+var sync_default = "name: Sync\n\non: # yamllint disable-line rule:truthy\n  workflow_call:\n    inputs:\n      steps:\n        description: >\n          Sync steps to run (default: all). Valid values:\n          labels, properties, teams, topics, keywords, description, homepage, readme, workflows, wiki.\n          Pass a space-separated list to run a subset, e.g. \"readme\" or \"readme wiki\".\n        type: string\n        required: false\n    secrets:\n      HOLOCRON_ADMIN_TOKEN:\n        description: Fine-grained PAT with admin scopes (labels, properties, teams).\n        required: false\n      HOLOCRON_DEPLOY_TOKEN:\n        description: Fine-grained PAT for GitHub Pages configuration.\n        required: false\n      HOLOCRON_ISSUES_TOKEN:\n        description: Fine-grained PAT for issue management.\n        required: false\n      HOLOCRON_ORG_TOKEN:\n        description: Org-scoped fine-grained PAT for team sync and org properties.\n        required: false\n      HOLOCRON_READ_TOKEN:\n        description: Fine-grained PAT for read-only GitHub API calls.\n        required: false\n      HOLOCRON_SYNC_TOKEN:\n        required: false\n      GH_TOKEN:\n        description: >\n          Generic GitHub token fallback for gh CLI calls. Used when\n          HOLOCRON_SYNC_TOKEN is not set.\n        required: false\n\njobs:\n  sync:\n    name: Sync repo from config\n    runs-on: ubuntu-latest\n    timeout-minutes: 10\n    permissions:\n      contents: write\n      pull-requests: write\n    steps:\n      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0\n        name: Checkout repository\n        with:\n          token: ${{ secrets.HOLOCRON_SYNC_TOKEN || secrets.GH_TOKEN || github.token }}\n\n      - uses: theholocron/.github/.github/actions/setup@main\n        name: Setup\n\n      - name: Run holocron sync\n        run: |\n          if [ -n \"$STEPS\" ]; then\n            # shellcheck disable=SC2086\n            pnpm --workspace-root exec holocron sync --steps $STEPS\n          else\n            pnpm --workspace-root exec holocron sync\n          fi\n        env:\n          HOLOCRON_ADMIN_TOKEN: ${{ secrets.HOLOCRON_ADMIN_TOKEN }}\n          HOLOCRON_DEPLOY_TOKEN: ${{ secrets.HOLOCRON_DEPLOY_TOKEN }}\n          HOLOCRON_ISSUES_TOKEN: ${{ secrets.HOLOCRON_ISSUES_TOKEN }}\n          HOLOCRON_ORG_TOKEN: ${{ secrets.HOLOCRON_ORG_TOKEN }}\n          HOLOCRON_READ_TOKEN: ${{ secrets.HOLOCRON_READ_TOKEN }}\n          HOLOCRON_SYNC_TOKEN: ${{ secrets.HOLOCRON_SYNC_TOKEN }}\n          STEPS: ${{ inputs.steps }}\n\n      - name: Format generated files\n        run: pnpm exec prettier --write README.md docs/src/content/docs/index.mdx 2>/dev/null || true\n\n      - uses: theholocron/.github/.github/actions/auto-commit@main\n        id: auto-commit\n        name: Commit sync changes\n        with:\n          token: ${{ secrets.HOLOCRON_SYNC_TOKEN || secrets.GH_TOKEN || github.token }}\n          branch: chore/auto-sync\n          commit-message: \"chore: sync from holocron.config\"\n          commit-options: \"--no-verify\"\n\n      - name: Open PR if changes were committed\n        if: steps.auto-commit.outputs.changes-detected == 'true'\n        run: |\n          gh pr create \\\n            --title \"chore: sync README and repo metadata\" \\\n            --body \"Automated sync triggered by changes to config or package files. Merge to apply.\" \\\n            --base main \\\n            --head chore/auto-sync \\\n          || echo \"PR already open — branch updated.\"\n        env:\n          GH_TOKEN: ${{ secrets.HOLOCRON_SYNC_TOKEN || secrets.GH_TOKEN || github.token }}\n\n      - name: Propagate wiki nav to all repos\n        if: >-\n          steps.auto-commit.outputs.changes-detected == 'true' &&\n          (inputs.steps == '' || contains(inputs.steps, 'wiki'))\n        run: |\n          gh workflow run sync-dispatch.yml \\\n            --repo theholocron/.github \\\n            --field \"steps=wiki\"\n        env:\n          GH_TOKEN: ${{ secrets.HOLOCRON_SYNC_TOKEN || secrets.GH_TOKEN || github.token }}\n";
 //#endregion
 //#region src/templates/workflows/sync-dispatch.yml
 var sync_dispatch_default = "name: Sync Dispatch\n\non: # yamllint disable-line rule:truthy\n  workflow_dispatch:\n    inputs:\n      steps:\n        description: >\n          Sync steps to pass to each repo's sync.yml. Default is \"readme\"\n          (only README marker blocks are updated).\n        type: string\n        required: false\n        default: readme\n\npermissions:\n  contents: read\n\njobs:\n  broadcast:\n    name: Broadcast sync to all repos\n    runs-on: ubuntu-latest\n    timeout-minutes: 15\n    steps:\n      - name: Dispatch sync to all repos with sync.yml\n        run: |\n          gh api /orgs/theholocron/repos --paginate --jq '.[].name' \\\n            | while IFS= read -r repo; do\n              gh api \"/repos/theholocron/$repo/contents/.github/workflows/sync.yml\" --silent 2>/dev/null || continue\n              echo \"Dispatching sync to theholocron/$repo\"\n              gh workflow run sync.yml \\\n                --repo \"theholocron/$repo\" \\\n                --field \"steps=$STEPS\" \\\n              || echo \"Warning: could not dispatch to theholocron/$repo — skipping\"\n            done\n        env:\n          GH_TOKEN: ${{ secrets.HOLOCRON_SYNC_TOKEN }}\n          STEPS: ${{ inputs.steps }}\n";