@theholocron/cli 3.63.0 → 3.64.0

package/dist/cli.mjs

@@ -2035,12 +2035,13 @@ export class ${inputs.capabilityClass} {
 	readonly key = "${inputs.capability}" as const;
 	readonly providerName = "${inputs.slug}";
 
-	constructor(private readonly rest: ${clientClass}) {}
+	constructor(private readonly rest: () => ${clientClass}) {}
 
 	// TODO: implement the ${capabilityInterface} interface methods
 	// (see \`packages/cli/src/capabilities/index.ts\`). Each method
 	// should hit a specific ${inputs.vendorName} REST endpoint via
-	// \`this.rest.request(...)\`. Once methods are stubbed, add
+	// \`this.rest().request(...)\` — call the thunk so the token is
+	// resolved lazily. Once methods are stubbed, add
 	// \`implements ${capabilityInterface}\` to the class declaration
 	// above and remove the \`as unknown as\` cast in src/index.ts.
 }
@@ -2061,7 +2062,7 @@ import { stubFetch } from "./helpers.js";
 function makeCapability() {
 	const stub = stubFetch([]);
 	const rest = new ${clientClass}({ token: "t", fetch: stub.fetch });
-	return new ${inputs.capabilityClass}(rest);
+	return new ${inputs.capabilityClass}(() => rest);
 }
 
 describe("${inputs.capabilityClass}", () => {
@@ -2254,17 +2255,21 @@ export interface ${inputs.vendorName}PluginOptions extends ResolveTokenInput {
 
 export interface PluginContext {
 	options: ${inputs.vendorName}PluginOptions;
-	rest: ${clientClass};
+	/** Memoized client — the token is resolved on first use, not at plugin load. */
+	rest: () => ${clientClass};
 }
 
 export function createContext(options: ${inputs.vendorName}PluginOptions): PluginContext {
-	const token = resolveToken(options);
-	const restOpts: ConstructorParameters<typeof ${clientClass}>[0] = { token };
-	if (options.baseUrl !== undefined) restOpts.baseUrl = options.baseUrl;
-	if (options.fetch !== undefined) restOpts.fetch = options.fetch;
+	let rest: ${clientClass} | undefined;
 	return {
 		options,
-		rest: new ${clientClass}(restOpts),
+		rest: () => {
+			if (rest) return rest;
+			const restOpts: ConstructorParameters<typeof ${clientClass}>[0] = { token: resolveToken(options) };
+			if (options.baseUrl !== undefined) restOpts.baseUrl = options.baseUrl;
+			if (options.fetch !== undefined) restOpts.fetch = options.fetch;
+			return (rest = new ${clientClass}(restOpts));
+		},
 	};
 }
 
@@ -3751,7 +3756,7 @@ function deriveDeployPaths(raw) {
 * configured. Paths are gitignored and regenerated on every setup run so the
 * content always reflects the current CLI version.
 *
-* Source: .notes/ai-engineering-workflow.spec.md
+* Source: docs/wiki/specifications/ai-engineering-workflow.spec.md
 */
 const DECISIONS_TEMPLATE = "---\nid: ADR-XXXX\ntitle: \"\"\nstatus: proposed\ndate: YYYY-MM-DD\nowners: []\nspecs: []\ndiscussion:\n  github:\nsupersedes: []\nsuperseded-by: []\ntags: []\n---\n\n# [Short title of the decision]\n\n- Status: [proposed | accepted | rejected | deprecated | superseded by ADR-XXXX]\n- Date: YYYY-MM-DD\n\n## Context and Problem Statement\n\n2–3 sentences describing the situation that forced this decision.\n\n## Decision Drivers\n\n- [driver 1 — a constraint, goal, or value]\n- [driver 2]\n\n## Considered Options\n\n- [Option A]\n- [Option B]\n- [Option C — do nothing]\n\n## Decision Outcome\n\nChosen option: **[Option A]**, because [one-sentence justification].\n\n### Positive Consequences\n\n- …\n\n### Negative Consequences\n\n- …\n\n## Pros and Cons of the Options\n\n### [Option A]\n\n- Good, because [argument]\n- Bad, because [argument]\n\n### [Option B]\n\n- Good, because [argument]\n- Bad, because [argument]\n";
 const AGENT_PROMPTS = {
@@ -5203,12 +5208,17 @@ const REGISTRY_MAP = {
 	"@theholocron/themes": getThemes,
 	"@theholocron/utils": getUtils
 };
-function generateInstallBlock(pkg) {
+function generateInstallBlock(pkg, homepage = "") {
 	const { name = "", bin, peerDependencies = {} } = pkg;
 	const isCli = Boolean(bin);
 	const isReact = Boolean(peerDependencies["react"]);
+	const isConsumable = isCli || !pkg.private || Boolean(pkg.main) || pkg.exports !== void 0;
 	const lines = [];
 	lines.push("## Installation", "");
+	if (!isConsumable) {
+		lines.push("This repository is a workspace root — it is not published. See the", "packages under [`packages/`](./packages) for the tools it ships.");
+		return lines.join("\n");
+	}
 	if (isCli) lines.push("```bash", `npm install --global ${name}`, "```");
 	else lines.push("```bash", `pnpm install ${name}`, "```");
 	lines.push("", "## Usage", "");
@@ -5217,8 +5227,9 @@ function generateInstallBlock(pkg) {
 		lines.push("```bash");
 		for (const cmd of commands) lines.push(`${cmd} --help`);
 		lines.push("```");
-	} else if (isReact) lines.push("```tsx", `import { } from "${name}";`, "", "function App() {", `  return <></>;`, "}", "```");
-	else lines.push("```typescript", `import { } from "${name}";`, "```");
+	} else if (isReact) lines.push("```tsx", `import {} from "${name}";`, "", "function App() {", `  return <></>;`, "}", "```");
+	else if (homepage) lines.push(`See the [documentation](${homepage}) for the API.`);
+	else lines.push("See the package documentation for the API.");
 	return lines.join("\n");
 }
 /**
@@ -5300,9 +5311,10 @@ async function runSyncReadme(input) {
 		};
 	}
 	const description = loaded.resolved.description ?? "";
+	const homepage = loaded.resolved.homepage ?? pkg.homepage ?? "";
 	const sections = generateReadme({
 		description,
-		homepage: loaded.resolved.homepage ?? pkg.homepage ?? "",
+		homepage,
 		scripts: pkg.scripts ?? {},
 		packages: pkg.name ? REGISTRY_MAP[pkg.name]?.() : void 0
 	});
@@ -5311,7 +5323,7 @@ async function runSyncReadme(input) {
 		development: sections.development,
 		releases: sections.releases
 	};
-	const updated = await updateReadme(repoRoot, generateInstallBlock(pkg), markerSections, dryRun, readFileFn, writeFileFn);
+	const updated = await updateReadme(repoRoot, generateInstallBlock(pkg, homepage), markerSections, dryRun, readFileFn, writeFileFn);
 	if (!updated) {
 		print(style.warn("README.md not found or has no writable location for installation block"));
 		logger.warn({