bosia 0.6.12 → 0.6.14

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "bosia",
-	"version": "0.6.12",
+	"version": "0.6.14",
 	"type": "module",
 	"description": "A fast, batteries-included fullstack framework — SSR · Svelte 5 Runes · Bun · ElysiaJS. File-based routing inspired by SvelteKit. No Node.js, no Vite, no adapters.",
 	"keywords": [

package/src/cli/add.ts

@@ -10,6 +10,7 @@ import {
 	mergePkgJson,
 	bunAdd,
 } from "./registry.ts";
+import { recordComponent, readManifest } from "./manifest.ts";
 
 // ─── bun x bosia@latest add <component> ──────────────────
 // Fetches a component from the GitHub registry (or local registry
@@ -164,9 +165,47 @@ export async function addComponent(name: string, root = false, options?: Install
 		}
 	}
 
+	// Record install in bosia.json manifest.
+	recordComponent(cwd, fullPath, {
+		files: meta.files,
+		...(Object.keys(meta.npmDeps).length > 0 ? { npmDeps: Object.keys(meta.npmDeps) } : {}),
+		...(meta.dependencies.length > 0 ? { dependencies: meta.dependencies } : {}),
+	});
+
 	if (root) console.log(`\n✅ ${name} installed at src/lib/components/${fullPath}/`);
 }
 
+// ─── bosia add list ───────────────────────────────────────
+
+export function runAddList(): void {
+	const manifest = readManifest();
+	const components = Object.entries(manifest.components);
+	const blocks = Object.entries(manifest.blocks);
+
+	if (components.length === 0 && blocks.length === 0) {
+		console.log("No components or blocks installed.");
+		console.log("Install one with: bun x bosia@latest add <component>");
+		return;
+	}
+
+	if (components.length > 0) {
+		console.log(`⬡ Installed components (${components.length}):\n`);
+		const w = Math.max(...components.map(([n]) => n.length));
+		for (const [name, entry] of components) {
+			console.log(`  ${name.padEnd(w)}  ${entry.installedAt.slice(0, 10)}`);
+		}
+	}
+
+	if (blocks.length > 0) {
+		if (components.length > 0) console.log("");
+		console.log(`⬡ Installed blocks (${blocks.length}):\n`);
+		const w = Math.max(...blocks.map(([n]) => n.length));
+		for (const [name, entry] of blocks) {
+			console.log(`  ${name.padEnd(w)}  ${entry.installedAt.slice(0, 10)}`);
+		}
+	}
+}
+
 // ─── Ensure $lib/utils.ts exists ─────────────────────────────
 
 const UTILS_CONTENT = `import { twMerge } from "tailwind-merge";

package/src/cli/block.ts

@@ -11,6 +11,7 @@ import {
 } from "./registry.ts";
 import { addComponent, initAddRegistry, ensureUtils } from "./add.ts";
 import { mergeFontImports } from "./fonts.ts";
+import { recordBlock } from "./manifest.ts";
 
 // ─── bun x bosia@latest add block <category>/<name> ──────
 // Installs a composed block into src/lib/blocks/<path>/.
@@ -108,5 +109,19 @@ export async function runAddBlock(
 		}
 	}
 
+	// 5. Record install in bosia.json manifest.
+	recordBlock(cwd, name, {
+		files: meta.files,
+		...(meta.npmDeps && Object.keys(meta.npmDeps).length > 0
+			? { npmDeps: Object.keys(meta.npmDeps) }
+			: {}),
+		...(meta.dependencies && meta.dependencies.length > 0
+			? { dependencies: meta.dependencies }
+			: {}),
+		...(meta.fonts && Object.keys(meta.fonts).length > 0
+			? { fonts: Object.keys(meta.fonts) }
+			: {}),
+	});
+
 	console.log(`\n✅ ${name} installed at src/lib/blocks/${name}/`);
 }

package/src/cli/feat.ts

@@ -11,6 +11,7 @@ import {
 	mergePkgJson,
 	bunAdd,
 } from "./registry.ts";
+import { recordFeature, readManifest } from "./manifest.ts";
 
 // ─── bun x bosia@latest feat <feature> [--local] ─────────
 // Fetches a feature scaffold from the GitHub registry (or local
@@ -268,6 +269,7 @@ export async function installFeature(name: string, isRoot: boolean, options?: In
 
 	// Apply each file entry per its strategy. Skip entries whose `when` clause doesn't match.
 	const createdDirs = new Set<string>();
+	const recordedFiles: { target: string; strategy: string; marker?: string }[] = [];
 	for (const entry of meta.files) {
 		if (entry.when && !whenMatches(entry.when, myOptions)) continue;
 		const dest = join(cwd, entry.target);
@@ -287,6 +289,11 @@ export async function installFeature(name: string, isRoot: boolean, options?: In
 			marker: entry.marker ?? name,
 			skipPrompts: nextOptions.skipPrompts ?? false,
 		});
+		recordedFiles.push({
+			target: entry.target,
+			strategy,
+			...(entry.marker ? { marker: entry.marker } : {}),
+		});
 	}
 
 	// Install npm dependencies
@@ -336,6 +343,32 @@ export async function installFeature(name: string, isRoot: boolean, options?: In
 		}
 	}
 
+	// Record install in bosia.json manifest (overwrites prior entry on re-install).
+	recordFeature(cwd, name, {
+		...(Object.keys(myOptions).length > 0 ? { options: myOptions } : {}),
+		files: recordedFiles,
+		...(Object.keys(meta.npmDeps).length > 0 ? { npmDeps: Object.keys(meta.npmDeps) } : {}),
+		...(meta.npmDevDeps && Object.keys(meta.npmDevDeps).length > 0
+			? { npmDevDeps: Object.keys(meta.npmDevDeps) }
+			: {}),
+		...(meta.envVars && Object.keys(meta.envVars).length > 0
+			? { envVars: Object.keys(meta.envVars) }
+			: {}),
+		...((meta.features && meta.features.length > 0) ||
+		meta.components.length > 0 ||
+		(meta.blocks && meta.blocks.length > 0)
+			? {
+					deps: {
+						...(meta.features && meta.features.length > 0
+							? { features: meta.features }
+							: {}),
+						...(meta.components.length > 0 ? { components: meta.components } : {}),
+						...(meta.blocks && meta.blocks.length > 0 ? { blocks: meta.blocks } : {}),
+					},
+				}
+			: {}),
+	});
+
 	if (isRoot) {
 		console.log(`\n✅ Feature "${name}" scaffolded!`);
 		if (meta.description) console.log(`   ${meta.description}`);
@@ -496,5 +529,29 @@ function isPlainObject(v: unknown): v is Record<string, unknown> {
 	return typeof v === "object" && v !== null && !Array.isArray(v);
 }
 
+// ─── bosia feat list ──────────────────────────────────────
+
+export function runFeatList(): void {
+	const manifest = readManifest();
+	const entries = Object.entries(manifest.features);
+	if (entries.length === 0) {
+		console.log("No features installed.");
+		console.log("Install one with: bun x bosia@latest feat <name>");
+		return;
+	}
+	console.log(`⬡ Installed features (${entries.length}):\n`);
+	const nameWidth = Math.max(...entries.map(([n]) => n.length));
+	for (const [name, entry] of entries) {
+		const opts = entry.options
+			? Object.entries(entry.options)
+					.map(([k, v]) => `${k}=${v}`)
+					.join(", ")
+			: "";
+		const date = entry.installedAt.slice(0, 10);
+		const optsSuffix = opts ? `  (${opts})` : "";
+		console.log(`  ${name.padEnd(nameWidth)}  ${date}${optsSuffix}`);
+	}
+}
+
 // Re-exports for create.ts
 export { resolveLocalRegistry, type InstallOptions } from "./registry.ts";

package/src/cli/index.ts

@@ -73,6 +73,9 @@ async function main() {
 			} else if (sub === "font") {
 				const { runAddFont } = await import("./font.ts");
 				await runAddFont(positional[1], positional[2]);
+			} else if (sub === "list") {
+				const { runAddList } = await import("./add.ts");
+				runAddList();
 			} else {
 				const { runAdd } = await import("./add.ts");
 				await runAdd(positional, flags);
@@ -80,12 +83,17 @@ async function main() {
 			break;
 		}
 		case "feat": {
+			const nameIdx = args.findIndex((a) => !a.startsWith("-"));
+			const featName = nameIdx === -1 ? undefined : args[nameIdx];
+			if (featName === "list") {
+				const { runFeatList } = await import("./feat.ts");
+				runFeatList();
+				break;
+			}
 			const { runFeat } = await import("./feat.ts");
 			// First non-flag token is the feature name; everything else flows through to the
 			// feature's own option parser. Global flags (-y, --local) are also accepted here
 			// and get split out inside runFeat.
-			const nameIdx = args.findIndex((a) => !a.startsWith("-"));
-			const featName = nameIdx === -1 ? undefined : args[nameIdx];
 			const rest =
 				nameIdx === -1 ? args : [...args.slice(0, nameIdx), ...args.slice(nameIdx + 1)];
 			await runFeat(featName, rest);
@@ -109,9 +117,11 @@ Commands:
   add block <cat>/<name>    Add a composed block from the registry
   add theme <name>          Add a theme (tokens.css) from the registry
   add font <family> <url>   Prepend an @import url(...) for a font family to src/app.css
+  add list                  List installed components and blocks (reads bosia.json)
   feat [-y] <feature> [feature options...]   Add a feature scaffold from the registry [--local]
                             -y / --yes auto-confirms prompts and uses each feature's default option values
                             Feature-specific options (e.g. file-upload's -d) follow the feature name
+  feat list                 List installed features (reads bosia.json)
 
 Examples:
   bun x bosia@latest create my-app
@@ -130,6 +140,8 @@ Examples:
   bun x bosia@latest add theme editorial
   bun x bosia@latest add font "Fredoka" "https://fonts.googleapis.com/css2?family=Fredoka:wght@400;700&display=swap"
   bun x bosia@latest feat login
+  bun x bosia feat list
+  bun x bosia add list
 `);
 			break;
 		}

package/src/cli/manifest.ts

@@ -0,0 +1,101 @@
+import { join } from "path";
+import { readFileSync, writeFileSync, existsSync } from "fs";
+
+// ─── bosia.json — committed install manifest ──────────────
+// Records features/components/blocks installed via the CLI so
+// `bosia feat list` and `bosia add list` can introspect project
+// state. Lays the groundwork for uninstall (Phase 2).
+
+export const MANIFEST_FILE = "bosia.json";
+const MANIFEST_VERSION = 1;
+
+export interface FeatureManifestEntry {
+	installedAt: string;
+	options?: Record<string, string>;
+	files: { target: string; strategy: string; marker?: string }[];
+	npmDeps?: string[];
+	npmDevDeps?: string[];
+	envVars?: string[];
+	deps?: {
+		features?: string[];
+		components?: string[];
+		blocks?: string[];
+	};
+}
+
+export interface ComponentManifestEntry {
+	installedAt: string;
+	files: string[];
+	npmDeps?: string[];
+	dependencies?: string[];
+}
+
+export interface BlockManifestEntry {
+	installedAt: string;
+	files: string[];
+	npmDeps?: string[];
+	dependencies?: string[];
+	fonts?: string[];
+}
+
+export interface Manifest {
+	version: number;
+	features: Record<string, FeatureManifestEntry>;
+	components: Record<string, ComponentManifestEntry>;
+	blocks: Record<string, BlockManifestEntry>;
+}
+
+function emptyManifest(): Manifest {
+	return { version: MANIFEST_VERSION, features: {}, components: {}, blocks: {} };
+}
+
+export function readManifest(cwd: string = process.cwd()): Manifest {
+	const path = join(cwd, MANIFEST_FILE);
+	if (!existsSync(path)) return emptyManifest();
+	try {
+		const parsed = JSON.parse(readFileSync(path, "utf-8")) as Partial<Manifest>;
+		return {
+			version: parsed.version ?? MANIFEST_VERSION,
+			features: parsed.features ?? {},
+			components: parsed.components ?? {},
+			blocks: parsed.blocks ?? {},
+		};
+	} catch {
+		return emptyManifest();
+	}
+}
+
+export function writeManifest(manifest: Manifest, cwd: string = process.cwd()): void {
+	const path = join(cwd, MANIFEST_FILE);
+	writeFileSync(path, JSON.stringify(manifest, null, 2) + "\n", "utf-8");
+}
+
+export function recordFeature(
+	cwd: string,
+	name: string,
+	entry: Omit<FeatureManifestEntry, "installedAt">,
+): void {
+	const manifest = readManifest(cwd);
+	manifest.features[name] = { installedAt: new Date().toISOString(), ...entry };
+	writeManifest(manifest, cwd);
+}
+
+export function recordComponent(
+	cwd: string,
+	fullPath: string,
+	entry: Omit<ComponentManifestEntry, "installedAt">,
+): void {
+	const manifest = readManifest(cwd);
+	manifest.components[fullPath] = { installedAt: new Date().toISOString(), ...entry };
+	writeManifest(manifest, cwd);
+}
+
+export function recordBlock(
+	cwd: string,
+	name: string,
+	entry: Omit<BlockManifestEntry, "installedAt">,
+): void {
+	const manifest = readManifest(cwd);
+	manifest.blocks[name] = { installedAt: new Date().toISOString(), ...entry };
+	writeManifest(manifest, cwd);
+}

package/src/core/plugins/inspector/index.ts

@@ -163,7 +163,11 @@ export function inspector(options: InspectorOptions = {}): BosiaPlugin | false {
 	if (process.env.NODE_ENV === "production") return false;
 	const editor = options.editor ?? "code";
 	const endpoint = options.endpoint ?? "/__bosia/locate";
-	const aiEndpoint = options.aiEndpoint;
+	// Env override lets hosts (e.g. bosapi running the app inside a podman
+	// container) point inspector POSTs at an address reachable from inside
+	// the sandbox, since the URL baked into bosia.config.ts resolves to the
+	// container's own loopback there.
+	const aiEndpoint = process.env.BOSIA_INSPECTOR_AI_ENDPOINT?.trim() || options.aiEndpoint;
 	const errorsEnabled = options.errorsEnabled !== false;
 
 	return {