@impulselab/cli 0.1.3 → 0.1.4

package/dist/index.js

@@ -211,7 +211,11 @@ import { z as z5 } from "zod";
 import { z as z2 } from "zod";
 var ModuleFileSchema = z2.object({
   src: z2.string(),
-  dest: z2.string()
+  dest: z2.string(),
+  /** If set, this file is only installed when the named module is already installed. */
+  when: z2.object({
+    moduleInstalled: z2.string()
+  }).optional()
 });
 
 // src/schemas/module-dependency.ts
@@ -243,11 +247,21 @@ var ModuleManifestSchema = z5.object({
   subModules: z5.array(z5.string()).default([]),
   dependencies: z5.array(ModuleDependencySchema).default([]),
   moduleDependencies: z5.array(z5.string()).default([]),
+  /** Optional module dependencies that enhance this module but are not required. */
+  optionalModuleDependencies: z5.array(z5.string()).default([]),
   files: z5.array(ModuleFileSchema).default([]),
   transforms: z5.array(ModuleTransformSchema).default([]),
   /** Documentation metadata listing env vars this module requires (displayed in install summary). */
   envVars: z5.array(z5.string()).default([]),
-  postInstall: z5.array(z5.string()).optional()
+  postInstall: z5.array(z5.string()).optional(),
+  /** Logical category for grouping in `impulse list`. */
+  category: z5.enum(["core", "feature", "integration", "dx"]).optional(),
+  /** Module names that cannot be installed alongside this module. */
+  incompatibleWith: z5.array(z5.string()).default([]),
+  /** Capability tokens this module provides (for future dependency resolution). */
+  provides: z5.array(z5.string()).default([]),
+  /** Which package in a monorepo this module targets. */
+  targetPackage: z5.enum(["database", "server", "web", "root"]).default("root")
 });
 
 // src/registry/github-urls.ts
@@ -364,7 +378,8 @@ async function listAvailableModules(localPath) {
         result.push({
           name: parsed.data.name,
           description: parsed.data.description,
-          ...subModules ? { subModules } : {}
+          ...subModules ? { subModules } : {},
+          ...parsed.data.category ? { category: parsed.data.category } : {}
         });
       } catch {
       }
@@ -432,9 +447,17 @@ import path5 from "path";
 import * as p2 from "@clack/prompts";
 var { outputFile, pathExists: pathExists6 } = fsExtra7;
 async function installFiles(options) {
-  const { moduleName, files, cwd, dryRun, localPath } = options;
+  const { moduleName, files, cwd, dryRun, localPath, installedModules = /* @__PURE__ */ new Set() } = options;
   const results = [];
   for (const file of files) {
+    if (file.when?.moduleInstalled !== void 0 && !installedModules.has(file.when.moduleInstalled)) {
+      results.push({
+        dest: file.dest,
+        action: "conditional-skip",
+        reason: `requires ${file.when.moduleInstalled}`
+      });
+      continue;
+    }
     const destAbs = path5.join(cwd, file.dest);
     const exists = await pathExists6(destAbs);
     if (exists) {
@@ -737,17 +760,26 @@ function installNpmDeps(deps, cwd, dryRun) {
   p5.log.step(`Installing dependencies: ${deps.join(", ")}`);
   execFileSync(pm, args, { cwd, stdio: "inherit" });
 }
-async function installModule(moduleId, manifest, cwd, dryRun, localPath) {
+async function installModule(moduleId, manifest, cwd, dryRun, installedModules, localPath) {
   p5.log.step(`Installing ${moduleId}@${manifest.version}...`);
+  const installedDests = [];
   if (manifest.files.length > 0) {
     const installed = await installFiles({
       moduleName: moduleId,
       files: manifest.files,
       cwd,
       dryRun,
-      localPath
+      localPath,
+      installedModules
     });
     for (const f of installed) {
+      if (f.action === "conditional-skip") {
+        if (dryRun) {
+          p5.log.message(`  \u25CB ${f.dest} [skipped: ${f.reason}]`);
+        }
+        continue;
+      }
+      installedDests.push(f.dest);
       const icon = f.action === "created" || f.action === "would-create" ? "+" : f.action === "overwritten" || f.action === "would-overwrite" ? "~" : "=";
       p5.log.message(`  ${icon} ${f.dest}`);
     }
@@ -756,14 +788,15 @@ async function installModule(moduleId, manifest, cwd, dryRun, localPath) {
     p5.log.step(`  transform: ${transform.type} \u2192 ${transform.target}`);
     await runTransform(transform, cwd, dryRun);
   }
+  return installedDests;
 }
-function recordModule(config, moduleId, manifest, now) {
+function recordModule(config, moduleId, manifest, installedFiles, now) {
   const existing = config.installedModules.findIndex((m) => m.name === moduleId);
   const record = {
     name: moduleId,
     version: manifest.version,
     installedAt: now,
-    files: manifest.files.map((f) => f.dest)
+    files: installedFiles
   };
   if (existing >= 0) {
     config.installedModules[existing] = record;
@@ -907,6 +940,19 @@ Available: ${parentManifest.subModules.join(", ")}`
   for (const id of orderedModules) {
     manifests.set(id, await fetchModuleManifest(id, localPath));
   }
+  for (const [id, manifest] of manifests) {
+    if (installedNames.has(id)) continue;
+    for (const incompatible of manifest.incompatibleWith) {
+      if (installedNames.has(incompatible)) {
+        p5.cancel(`Module "${id}" is incompatible with installed module "${incompatible}".`);
+        process.exit(1);
+      }
+      if (manifests.has(incompatible) && !installedNames.has(incompatible)) {
+        p5.cancel(`Module "${id}" is incompatible with module "${incompatible}" (also being installed).`);
+        process.exit(1);
+      }
+    }
+  }
   const allDeps = /* @__PURE__ */ new Set();
   for (const manifest of manifests.values()) {
     for (const dep of manifest.dependencies) {
@@ -951,13 +997,16 @@ Available: ${parentManifest.subModules.join(", ")}`
   const primaryTargetSet = new Set(allTargets);
   const depModules = orderedModules.filter((id) => !primaryTargetSet.has(id) && !installedNames.has(id));
   const targetModules = orderedModules.filter((id) => primaryTargetSet.has(id));
+  const installedFilesMap = /* @__PURE__ */ new Map();
   const depPostInstallHooks = [];
   if (depModules.length > 0) {
     p5.log.step(`Installing module dependencies: ${depModules.join(", ")}`);
     for (const dep of depModules) {
       const depManifest = manifests.get(dep);
       if (!depManifest) continue;
-      await installModule(dep, depManifest, cwd, dryRun, localPath);
+      const dests = await installModule(dep, depManifest, cwd, dryRun, installedNames, localPath);
+      installedFilesMap.set(dep, dests);
+      installedNames.add(dep);
       if (depManifest.postInstall && depManifest.postInstall.length > 0) {
         depPostInstallHooks.push({ name: dep, hooks: depManifest.postInstall });
       }
@@ -966,7 +1015,9 @@ Available: ${parentManifest.subModules.join(", ")}`
   for (const targetId of targetModules) {
     const targetManifest = manifests.get(targetId);
     if (!targetManifest) continue;
-    await installModule(targetId, targetManifest, cwd, dryRun, localPath);
+    const dests = await installModule(targetId, targetManifest, cwd, dryRun, installedNames, localPath);
+    installedFilesMap.set(targetId, dests);
+    installedNames.add(targetId);
   }
   installNpmDeps([...allDeps], cwd, dryRun);
   if (!dryRun) {
@@ -993,11 +1044,13 @@ Available: ${parentManifest.subModules.join(", ")}`
     const now = (/* @__PURE__ */ new Date()).toISOString();
     for (const dep of depModules) {
       const depManifest = manifests.get(dep);
-      if (depManifest) recordModule(config, dep, depManifest, now);
+      const dests = installedFilesMap.get(dep) ?? [];
+      if (depManifest) recordModule(config, dep, depManifest, dests, now);
     }
     for (const targetId of targetModules) {
       const targetManifest = manifests.get(targetId);
-      if (targetManifest) recordModule(config, targetId, targetManifest, now);
+      const dests = installedFilesMap.get(targetId) ?? [];
+      if (targetManifest) recordModule(config, targetId, targetManifest, dests, now);
     }
     await writeConfig(config, cwd);
   }
@@ -1009,6 +1062,24 @@ Available: ${parentManifest.subModules.join(", ")}`
 
 // src/commands/list.ts
 import * as p6 from "@clack/prompts";
+function printModule(mod, installedNames, installedModules) {
+  const installed = installedNames.has(mod.name);
+  const installedInfo = installed ? installedModules?.find((m) => m.name === mod.name) : null;
+  const status = installed ? `[installed v${installedInfo?.version ?? "?"}]` : "[available]";
+  const desc = mod.description ? ` \u2014 ${mod.description}` : "";
+  p6.log.message(`  ${installed ? "\u2713" : "\u25CB"} ${mod.name} ${status}${desc}`);
+  if (mod.subModules && mod.subModules.length > 0) {
+    const last = mod.subModules.length - 1;
+    mod.subModules.forEach((sub, i) => {
+      const subId = `${mod.name}/${sub}`;
+      const subInstalled = installedNames.has(subId);
+      const subInfo = subInstalled ? installedModules?.find((m) => m.name === subId) : null;
+      const subStatus = subInstalled ? `[installed v${subInfo?.version ?? "?"}]` : "[not installed]";
+      const connector = i === last ? "\u2514\u2500" : "\u251C\u2500";
+      p6.log.message(`    ${connector} ${sub} ${subStatus}`);
+    });
+  }
+}
 async function runList(options) {
   const { cwd, localPath } = options;
   p6.intro("impulse list");
@@ -1034,22 +1105,33 @@ async function runList(options) {
     return;
   }
   p6.log.message("\nAvailable modules:\n");
-  for (const mod of available) {
-    const installed = installedNames.has(mod.name);
-    const installedInfo = installed ? config?.installedModules.find((m) => m.name === mod.name) : null;
-    const status = installed ? `[installed v${installedInfo?.version ?? "?"}]` : "[available]";
-    const desc = mod.description ? ` \u2014 ${mod.description}` : "";
-    p6.log.message(`  ${installed ? "\u2713" : "\u25CB"} ${mod.name} ${status}${desc}`);
-    if (mod.subModules && mod.subModules.length > 0) {
-      const last = mod.subModules.length - 1;
-      mod.subModules.forEach((sub, i) => {
-        const subId = `${mod.name}/${sub}`;
-        const subInstalled = installedNames.has(subId);
-        const subInfo = subInstalled ? config?.installedModules.find((m) => m.name === subId) : null;
-        const subStatus = subInstalled ? `[installed v${subInfo?.version ?? "?"}]` : "[not installed]";
-        const connector = i === last ? "\u2514\u2500" : "\u251C\u2500";
-        p6.log.message(`    ${connector} ${sub} ${subStatus}`);
-      });
+  const hasCategories = available.some((m) => m.category !== void 0);
+  if (hasCategories) {
+    const groups = /* @__PURE__ */ new Map();
+    for (const mod of available) {
+      const key = mod.category ?? "other";
+      const existing = groups.get(key);
+      if (existing) {
+        existing.push(mod);
+      } else {
+        groups.set(key, [mod]);
+      }
+    }
+    const categoryOrder = ["core", "feature", "integration", "dx", "other"];
+    const sortedKeys = [
+      ...categoryOrder.filter((k) => groups.has(k)),
+      ...[...groups.keys()].filter((k) => !categoryOrder.includes(k))
+    ];
+    for (const key of sortedKeys) {
+      p6.log.message(`${key.toUpperCase()}`);
+      for (const mod of groups.get(key)) {
+        printModule(mod, installedNames, config?.installedModules);
+      }
+      p6.log.message("");
+    }
+  } else {
+    for (const mod of available) {
+      printModule(mod, installedNames, config?.installedModules);
     }
   }
   p6.log.message(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@impulselab/cli",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "ImpulseLab CLI — install and manage modules for your projects",
   "private": false,
   "type": "module",