@theholocron/cli 2.0.0-alpha.62 → 2.0.0-alpha.64

package/dist/cli.mjs

@@ -3,11 +3,13 @@ import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSy
 import path, { basename, dirname, join } from "node:path";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
+import { createInterface } from "node:readline";
+import { stdin, stdout } from "node:process";
 import { ProviderApiError, ProviderApiError as ProviderApiError$1 } from "@theholocron/http-client";
 import { Entry, findCredentials } from "@napi-rs/keyring";
 import { createHash } from "node:crypto";
 import { createGitHubClient } from "@theholocron/github-client";
-import { execFile, spawnSync } from "node:child_process";
+import { execFile, execFileSync, spawnSync } from "node:child_process";
 import { access, readFile, readdir, stat, writeFile } from "node:fs/promises";
 import { pathToFileURL } from "node:url";
 import { promisify } from "node:util";
@@ -948,8 +950,8 @@ jobs:
           BUILD_SCRIPT: \${{ inputs.build-script }}
           CODECOV_TOKEN: \${{ secrets.CODECOV_TOKEN }}
 `,
-	"bookkeeping-pr": `\
-name: PR Bookkeeping
+	bookkeeping: `\
+name: Bookkeeping
 
 on: # yamllint disable-line rule:truthy
   workflow_call:
@@ -962,7 +964,7 @@ on: # yamllint disable-line rule:truthy
 
 jobs:
   label:
-    name: Add Labels to PRs
+    name: Apply Labels
     permissions:
       contents: read
       issues: write
@@ -970,7 +972,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 5
     concurrency:
-      group: bookkeeping-pr-\${{ github.event.pull_request.number }}
+      group: bookkeeping-\${{ github.event.pull_request.number || github.event.issue.number }}
       cancel-in-progress: true
     steps:
       - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
@@ -1902,14 +1904,18 @@ jobs:
     uses: ${ref("dependencies")}
     secrets: inherit
 `,
-	"bookkeeping-pr": `\
-name: PR Bookkeeping
+	bookkeeping: `\
+name: Bookkeeping
 
 on: # yamllint disable-line rule:truthy
   pull_request:
     types:
       - opened
       - edited
+  issues:
+    types:
+      - opened
+      - edited
 
 permissions:
   contents: read
@@ -1918,7 +1924,7 @@ permissions:
 
 jobs:
   bookkeeping:
-    uses: ${ref("bookkeeping-pr")}
+    uses: ${ref("bookkeeping")}
     secrets: inherit
 `,
 	audit: `\
@@ -2361,7 +2367,7 @@ async function runNpmPublishInitial(input = {}) {
 	const dryRun = input.dryRun ?? false;
 	const otp = input.otp;
 	const env = input.env ?? process.env;
-	const exec = input.exec ?? defaultExec;
+	const exec = input.exec ?? defaultExec$1;
 	const publishArgs = [
 		"-r",
 		"--filter=./packages/*",
@@ -2437,7 +2443,7 @@ function printNextSteps$1(print, env) {
 		print("    https://www.npmjs.com/settings/~/tokens");
 	}
 }
-const defaultExec = async (cmd, args, opts) => {
+const defaultExec$1 = async (cmd, args, opts) => {
 	const result = spawnSync(cmd, args, {
 		cwd: opts.cwd,
 		encoding: "utf8",
@@ -3288,13 +3294,11 @@ export default defineConfig({
 *   2. Slug collision — packages/holocron-plugin-<slug>/ must not exist.
 *   3. Capability sanity — must be one of the 14 known keys; warn for
 *      many-cardinality caps.
-*   4. Prompt — fill in any missing flags via cli-utils / inquirer
-*      (Phase B; Phase A takes fully-populated input).
-*   5. Generate — for each template, write to
+*   4. Generate — for each template, write to
 *      packages/holocron-plugin-<slug>/<path>.
-*   6. Verify (unless --no-verify) — Phase B; runs pnpm install +
+*   5. Verify (unless --no-verify) — runs pnpm install +
 *      pnpm --filter <pkg> typecheck lint test.
-*   7. Print next steps.
+*   6. Print next steps.
 */
 var PluginCreateError = class extends Error {
 	name = "PluginCreateError";
@@ -3417,6 +3421,51 @@ function runPluginCreate(input) {
 		}
 		filesWritten.push(resolvedPath);
 	}
+	if (!input.dryRun && !input.noVerify) {
+		const execFn = input.exec ?? defaultExec;
+		const pkg = `@theholocron/holocron-plugin-${inputs.slug}`;
+		print("");
+		print("  Verifying scaffold…");
+		try {
+			execFn("pnpm", ["install", "--frozen-lockfile=false"], {
+				cwd,
+				stdio: "inherit"
+			});
+			execFn("pnpm", [
+				"--filter",
+				pkg,
+				"typecheck"
+			], {
+				cwd,
+				stdio: "inherit"
+			});
+			execFn("pnpm", [
+				"--filter",
+				pkg,
+				"lint"
+			], {
+				cwd,
+				stdio: "inherit"
+			});
+			execFn("pnpm", [
+				"--filter",
+				pkg,
+				"test"
+			], {
+				cwd,
+				stdio: "inherit"
+			});
+			print("  ✓ scaffold verified");
+		} catch (err) {
+			print(`  ✗ verify failed — ${err instanceof Error ? err.message : String(err)}`);
+			return {
+				status: "fail",
+				packagePath: packageDir,
+				filesWritten,
+				message: "post-scaffold verify failed; inspect output above"
+			};
+		}
+	}
 	if (!input.dryRun) printNextSteps(print, inputs);
 	return {
 		status: "ok",
@@ -3460,6 +3509,12 @@ function defaultWrite(filepath, content) {
 	mkdirSync(path.dirname(filepath), { recursive: true });
 	writeFileSync(filepath, content, "utf8");
 }
+function defaultExec(cmd, args, opts) {
+	execFileSync(cmd, args, {
+		cwd: opts.cwd,
+		stdio: opts.stdio
+	});
+}
 function printNextSteps(print, inputs) {
 	print("");
 	print(`  Scaffolded @theholocron/holocron-plugin-${inputs.slug} (18 files).`);
@@ -4148,7 +4203,7 @@ async function runSetup(input) {
 			print(formatStep(steps[steps.length - 1]));
 		}
 	}
-	if (loader.has("source") && (config.workflows ?? []).map((e) => typeof e === "string" ? e : e.name).includes("bookkeeping-pr")) {
+	if (loader.has("source") && (config.workflows ?? []).map((e) => typeof e === "string" ? e : e.name).includes("bookkeeping")) {
 		const source = loader.get("source");
 		steps.push(await runStep("source", "write .github/labeler.yml", dryRun, async () => {
 			await source.writeRepoFile(".github/labeler.yml", labelerConfig());
@@ -4361,8 +4416,9 @@ async function runStep(capability, step, dryRun, body) {
 	}
 }
 function classify403(err) {
-	const msg = `${err.message} ${String(err.details)}`.toLowerCase();
-	if (msg.includes("advanced security") || msg.includes("not enabled for this repository") || msg.includes("upgrade") || msg.includes("not available on")) return "plan";
+	const detailText = typeof err.details === "string" ? err.details : typeof err.details === "object" && err.details !== null && "message" in err.details ? String(err.details.message) : "";
+	const text = `${err.message} ${detailText}`.toLowerCase();
+	if (text.includes("advanced security") || text.includes("not enabled for this repository") || text.includes("upgrade") || text.includes("not available on")) return "plan";
 	return "permissions";
 }
 function formatStep(step) {
@@ -4938,15 +4994,40 @@ await yargs(hideBin(process.argv)).scriptName("holocron").usage("$0 <command> [o
 	type: "boolean",
 	default: true,
 	describe: "Run post-scaffold pnpm install + typecheck + lint + test (default true; --no-verify skips)"
-}), (argv) => {
+}), async (argv) => {
 	try {
-		if (!argv.capability || !argv.vendorEnv || !argv.baseUrl) throw new PluginCreateError("Phase A: --capability, --vendor-env, and --base-url are required. Interactive prompts land in Phase B.");
+		const capabilityKeys = Object.keys(CARDINALITY).join(", ");
+		const needsPrompt = !argv.capability || !argv.vendorEnv || !argv.baseUrl;
+		let capability;
+		let vendorEnv;
+		let baseUrl;
+		if (needsPrompt) {
+			const rl = createInterface({
+				input: stdin,
+				output: stdout
+			});
+			const ask = (question) => new Promise((resolve) => rl.question(`  ${question} `, (answer) => resolve(answer.trim())));
+			try {
+				if (!argv.capability) {
+					console.log(`  Available capabilities: ${capabilityKeys}`);
+					capability = await ask("Capability:");
+				} else capability = argv.capability;
+				vendorEnv = argv.vendorEnv ? argv.vendorEnv : await ask(`Vendor-native env var for the ${argv.vendor} token (e.g. MYVENDOR_API_KEY):`);
+				baseUrl = argv.baseUrl ? argv.baseUrl : await ask(`REST base URL for the ${argv.vendor} API (e.g. https://api.myvendor.com):`);
+			} finally {
+				rl.close();
+			}
+		} else {
+			capability = argv.capability;
+			vendorEnv = argv.vendorEnv;
+			baseUrl = argv.baseUrl;
+		}
 		if (runPluginCreate({
 			slug: argv.slug,
 			vendorName: argv.vendor,
-			capability: argv.capability,
-			vendorEnv: argv.vendorEnv,
-			baseUrl: argv.baseUrl,
+			capability,
+			vendorEnv,
+			baseUrl,
 			...argv.tokenEnv ? { tokenEnv: argv.tokenEnv } : {},
 			dryRun: argv.dryRun,
 			noVerify: !argv.verify,

package/dist/index.d.mts

@@ -77,7 +77,7 @@ interface HolocronConfig {
    * Use the object form to pass `with:` inputs to the reusable workflow.
    *
    * Supported values: "lint" | "test" | "typecheck" | "codeql" | "review" |
-   *   "release" | "stale" | "greetings" | "dependencies" | "bookkeeping-pr" | "audit"
+   *   "release" | "stale" | "greetings" | "dependencies" | "bookkeeping" | "audit"
    *
    * `holocron setup` writes `.github/workflows/<name>.yml` for each entry,
    * calling the corresponding `ci-<name>.yml@main` reusable workflow.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/cli",
-  "version": "2.0.0-alpha.62",
+  "version": "2.0.0-alpha.64",
   "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",