stackpack-cli 0.3.2 → 0.3.4

package/README.md

@@ -112,6 +112,8 @@ Framework-specific filtering applies automatically — e.g. React Router is hidd
 stackpack                          # interactive main menu
 stackpack new <project-name>       # create a project with an official creator
 stackpack new my-app --preset jc-react-stack
+stackpack install <preset> [name]  # express mode: whole stack in one shot
+stackpack i <preset> [name]        # same, shorter
 stackpack add                      # add integrations to the current project
 stackpack add --dry-run            # full plan, zero changes
 stackpack add --package-manager pnpm
@@ -120,6 +122,7 @@ stackpack save <name> [--local|--global]
 stackpack apply <name> [--dry-run] # apply a preset to the current project
 stackpack presets list
 stackpack presets show <name>
+stackpack presets edit <name>      # swap integrations, save back — no project touched
 stackpack presets delete <name>
 stackpack --no-color
 ```

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 //#region src/cli.ts
 if (process.argv.includes("--no-color")) process.env.NO_COLOR = "1";
-const { runCli } = await import("./program-CqWM02UT.js");
+const { runCli } = await import("./program-Cis7OMvk.js");
 await runCli(process.argv);
 process.exit(process.exitCode ?? 0);
 //#endregion

package/dist/{program-CqWM02UT.js → program-Cis7OMvk.js}

@@ -2477,16 +2477,45 @@ function testingLabel(selection) {
 	if (selection.testing.length === 0) return void 0;
 	return selection.testing.map((entry) => getRecipe(entry.id)?.name ?? entry.id).join(" + ");
 }
-/** Category rows turn green with a check once something is selected. */
-function categoryOption(value, label, selected) {
-	return selected ? {
+/**
+* Project inventory per category: what is already installed in the project
+* (detected from real files/packages), independent of this session's picks.
+*/
+function installedSummary(availabilities, category) {
+	const entries = availabilities.filter((a) => a.recipe.category === category && (a.compatibility === "already-installed" || a.compatibility === "partially-configured"));
+	if (entries.length === 0) return void 0;
+	return {
+		label: entries.map((a) => {
+			const version = a.detection.installedVersion;
+			const base = version ? `${a.recipe.name} ${version}` : a.recipe.name;
+			return a.compatibility === "partially-configured" ? `${base} — partial setup` : base;
+		}).join(" + "),
+		partial: entries.some((a) => a.compatibility === "partially-configured")
+	};
+}
+/**
+* Category rows show this session's picks first (green check), otherwise what
+* the project already has installed, otherwise that the slot is open.
+*/
+function categoryOption(value, label, selected, installed) {
+	if (selected) return {
 		value,
 		label: `${label} ${pc.green("✓")}`,
 		hint: pc.green(selected)
+	};
+	if (installed) return installed.partial ? {
+		value,
+		label: `${label} ${pc.yellow("⚠")}`,
+		hint: pc.yellow(`installed: ${installed.label}`)
 	} : {
+		value,
+		label: `${label} ${pc.green("●")}`,
+		hint: pc.dim(`installed: ${installed.label}`)
+	};
+	return {
 		value,
 		label,
-		hint: "Not selected"
+		hint: "Not installed"
 	};
 }
 function categoryHasVisibleRecipes(availabilities, category) {
@@ -2496,7 +2525,8 @@ function categoryHasVisibleRecipes(availabilities, category) {
 * The jumpable category dashboard. Selections persist in memory while the
 * user moves between categories; nothing is installed here.
 */
-async function runDashboard(context, selection) {
+async function runDashboard(context, selection, options = {}) {
+	const reviewLabel = options.reviewLabel ?? "Review and Install";
 	for (;;) {
 		const availabilities = filterIntegrations(context, allRecipes);
 		const count = selectedIntegrationCount(selection);
@@ -2504,13 +2534,13 @@ async function runDashboard(context, selection) {
 		const overrideCount = Object.keys(selection.versionOverrides).length;
 		p.log.info(`Selected integrations: ${count}   Additional packages: ${customCount}${overrideCount > 0 ? `   Version overrides: ${overrideCount}` : ""}`);
 		const options = [];
-		if (categoryHasVisibleRecipes(availabilities, "routing")) options.push(categoryOption("routing", "Routing", selectionLabel(selection.routing)));
-		options.push(categoryOption("state-management", "State Management", selectionLabel(selection.stateManagement)), categoryOption("data-fetching", "Data Fetching and API", selectionLabel(selection.dataFetching)), categoryOption("forms-validation", "Forms and Validation", selectionLabel(selection.formsAndValidation)), categoryOption("ui", "UI Components", selectionLabel(selection.ui)), categoryOption("orm", "Database / ORM", selectionLabel(selection.orm)), categoryOption("testing", "Testing", testingLabel(selection)), categoryOption("custom-packages", "Custom Packages", customCount > 0 ? `${customCount} package${customCount === 1 ? "" : "s"}` : void 0), {
+		if (categoryHasVisibleRecipes(availabilities, "routing")) options.push(categoryOption("routing", "Routing", selectionLabel(selection.routing), installedSummary(availabilities, "routing")));
+		options.push(categoryOption("state-management", "State Management", selectionLabel(selection.stateManagement), installedSummary(availabilities, "state-management")), categoryOption("data-fetching", "Data Fetching and API", selectionLabel(selection.dataFetching), installedSummary(availabilities, "data-fetching")), categoryOption("forms-validation", "Forms and Validation", selectionLabel(selection.formsAndValidation), installedSummary(availabilities, "forms-validation")), categoryOption("ui", "UI Components", selectionLabel(selection.ui), installedSummary(availabilities, "ui")), categoryOption("orm", "Database / ORM", selectionLabel(selection.orm), installedSummary(availabilities, "orm")), categoryOption("testing", "Testing", testingLabel(selection), installedSummary(availabilities, "testing")), categoryOption("custom-packages", "Custom Packages", customCount > 0 ? `${customCount} package${customCount === 1 ? "" : "s"}` : void 0), {
 			value: "versions",
 			label: "Edit Package Versions"
 		}, {
 			value: "review",
-			label: "Review and Install"
+			label: reviewLabel
 		});
 		switch (guard(await p.select({
 			message: "Choose a category",
@@ -4131,6 +4161,43 @@ async function ensureDependenciesInstalled(destination, packageManager) {
 	const result = await realCommandRunner(baseInstallCommand(packageManager, destination));
 	if (result.exitCode !== 0) p.log.warn(`Dependency installation failed (exit code ${result.exitCode}). Run "${packageManager} install" inside the project to finish setup.`);
 }
+/**
+* Express install: create a project from a saved preset in one shot, like the
+* official create-* tools but with the whole stack. Skips the intermediate
+* confirmations of runNew; the review screen is the single decision point.
+*/
+async function runExpressInstall(presetName, projectNameArg, options = {}) {
+	p.intro("StackPack — express install");
+	const { preset, location } = await loadPreset(presetName, { projectRoot: process.cwd() });
+	p.log.info(`Preset: ${preset.displayName ?? preset.name} ${pc.dim(`(${location.scope} — ${preset.integrations.length} integrations)`)}`);
+	if (!await confirmIfInsideExistingProject()) throw new CancelledError();
+	const { name, destination } = await askProjectName(projectNameArg);
+	const creator = getCreator(preset.base.creator);
+	const config = await loadConfig();
+	const packageManager = options.packageManager ?? config.defaultPackageManager ?? "npm";
+	await runOfficialCreator(creator, name, { language: preset.base.language }, packageManager);
+	const context = await detectProject(destination, { packageManagerOverride: packageManager });
+	if (context.detection === "unsupported") {
+		p.log.warn("The generated project is not a supported React or Next.js project, so the preset's integrations cannot be applied.");
+		await ensureDependenciesInstalled(destination, packageManager);
+		p.outro(`Base project created at ${destination}. No integrations were installed.`);
+		return;
+	}
+	if (await dashboardInstallLoop({
+		context,
+		selection: presetToSelection(preset),
+		dryRun: false,
+		startAtReview: true,
+		sourcePreset: preset
+	}) === "cancelled") {
+		await ensureDependenciesInstalled(destination, packageManager);
+		p.outro(`Base project created at ${destination}. No integrations were installed.`);
+		return;
+	}
+	await ensureDependenciesInstalled(destination, packageManager);
+	p.note(`cd ${name}\n${packageManager} run dev`, "Next steps");
+	p.outro(`Project ready at ${destination} — good to go!`);
+}
 async function runNew(projectNameArg, options) {
 	p.intro("StackPack — new project");
 	p.log.message(pc.dim("Official project tooling with real-world integrations."));
@@ -4602,6 +4669,11 @@ async function runPresetsBrowser(options = {}) {
 					value: "list",
 					label: "Back to preset list"
 				},
+				{
+					value: "edit",
+					label: "Edit this preset",
+					hint: "swap integrations, save back"
+				},
 				{
 					value: "delete",
 					label: "Delete this preset"
@@ -4613,6 +4685,10 @@ async function runPresetsBrowser(options = {}) {
 			]
 		}));
 		if (action === "menu") return;
+		if (action === "edit") {
+			await runPresetsEdit(selected.name, { cwd: projectRoot });
+			continue;
+		}
 		if (action === "delete") {
 			if (guard(await p.confirm({
 				message: `Delete preset "${selected.name}"?`,
@@ -4624,6 +4700,65 @@ async function runPresetsBrowser(options = {}) {
 		}
 	}
 }
+/**
+* Editing a preset never touches a real project, so the dashboard runs
+* against a synthetic context built from the preset's own project shape.
+*/
+function contextForPresetEditing(preset) {
+	return {
+		rootDirectory: process.cwd(),
+		framework: preset.project.framework,
+		buildTool: preset.project.buildTool,
+		language: preset.project.language,
+		packageManager: "npm",
+		packageManagerCandidates: [],
+		detection: "detected",
+		packageJson: {},
+		detectedFiles: [],
+		installedPackages: {}
+	};
+}
+/**
+* Save-and-load editing: open a preset in the dashboard, change integrations,
+* and write it back to the same file. No project is created or modified.
+*/
+async function runPresetsEdit(name, options = {}) {
+	const projectRoot = options.cwd ?? process.cwd();
+	const { preset, location } = await loadPreset(name, { projectRoot });
+	p.log.info(`Editing ${location.scope} preset: ${location.filePath}`);
+	p.log.message(pc.dim("Changes apply to the preset file only — no project is created or modified."));
+	const context = contextForPresetEditing(preset);
+	const selection = presetToSelection(preset);
+	if (await runDashboard(context, selection, { reviewLabel: "Finish editing" }) !== "review") return;
+	if (selectionMatchesPreset(preset, selection)) {
+		p.log.info(`No changes made — preset "${preset.name}" is untouched.`);
+		return;
+	}
+	const rebuilt = buildPresetFromSelection({
+		name: preset.name,
+		scope: location.scope,
+		context,
+		selection
+	});
+	if (!rebuilt) {
+		p.log.warn("This preset cannot be rebuilt (unknown framework or language). Nothing saved.");
+		return;
+	}
+	const updated = {
+		...rebuilt,
+		displayName: preset.displayName ?? preset.name,
+		createdAt: preset.createdAt
+	};
+	if (!guard(await p.confirm({
+		message: `Save changes to preset "${preset.name}"?`,
+		initialValue: true
+	}))) {
+		p.log.info("Changes discarded — the preset file was not modified.");
+		return;
+	}
+	const saved = await savePreset(updated, location.scope, { projectRoot });
+	p.log.success(`Preset updated: ${saved.filePath}`);
+}
 async function runPresetsDelete(name, options = {}) {
 	const storeOptions = { projectRoot: options.cwd ?? process.cwd() };
 	p.intro("StackPack — delete preset");
@@ -4693,7 +4828,7 @@ async function getUpdateNotice(currentVersion) {
 }
 //#endregion
 //#region src/version.ts
-const VERSION = "0.3.2";
+const VERSION = "0.3.4";
 //#endregion
 //#region src/program.ts
 const packageManagerOption = new Option("--package-manager <manager>", "package manager to use").choices([
@@ -4789,6 +4924,9 @@ async function runCli(argv) {
 	program.command("apply").description("Apply a saved preset's integrations to the current project").argument("<preset-name>", "preset to apply").option("--dry-run", "show the full plan without changing anything").action(async (name, options) => {
 		await runApply(name, options);
 	});
+	program.command("install").alias("i").description("Create a project from a saved preset in one shot (express mode)").argument("<preset-name>", "saved preset to install from").argument("[project-name]", "project folder to create (asked interactively if omitted)").addOption(packageManagerOption).action(async (presetName, projectName, options) => {
+		await runExpressInstall(presetName, projectName, options);
+	});
 	const presets = program.command("presets").description("Manage saved presets");
 	presets.command("list").description("List saved presets (global and project-local)").action(async () => {
 		await runPresetsList();
@@ -4796,6 +4934,9 @@ async function runCli(argv) {
 	presets.command("show").description("Show a preset's contents").argument("<preset-name>").action(async (name) => {
 		await runPresetsShow(name);
 	});
+	presets.command("edit").description("Edit a saved preset's integrations (no project is touched)").argument("<preset-name>").action(async (name) => {
+		await runPresetsEdit(name);
+	});
 	presets.command("delete").description("Delete a saved preset").argument("<preset-name>").action(async (name) => {
 		await runPresetsDelete(name);
 	});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stackpack-cli",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Local-first, privacy-focused terminal integration builder for JavaScript and TypeScript projects. Official tooling first, presets stay on your device.",
   "type": "module",
   "license": "MIT",
@@ -20,7 +20,7 @@
     "dist"
   ],
   "engines": {
-    "node": ">=18.17"
+    "node": ">=22"
   },
   "scripts": {
     "dev": "tsx src/cli.ts",