@dawitworku/projectcli 0.2.1 → 3.0.0

package/src/index.js

@@ -28,13 +28,20 @@ try {
 const { getLanguages, getFrameworks, getGenerator } = require("./registry");
 const { runSteps } = require("./run");
 const { runAdd } = require("./add");
-const { checkBinaries } = require("./preflight");
+const { checkBinaries, getInstallHint } = require("./preflight");
 const { gitClone, removeGitFolder } = require("./remote");
 const { generateCI, generateDocker } = require("./cicd");
+const { generateDevContainer } = require("./devcontainer");
+const { generateLicense, licenseTypes } = require("./license");
 const { getDescription } = require("./descriptions");
 const { detectLanguage, detectPackageManager } = require("./detect");
-const { loadConfig } = require("./config");
+const { loadConfig, loadProjectConfig } = require("./config");
 const { runConfig } = require("./settings");
+const { runDoctor } = require("./core/doctor");
+const { runPreset } = require("./preset");
+const { getPreset } = require("./presets");
+const { runUpgrade } = require("./upgrade");
+const { runPlugin } = require("./plugin");
 
 const RUST_KEYWORDS = new Set(
   [
@@ -138,6 +145,8 @@ function parseArgs(argv) {
     pm: undefined,
     ci: false,
     docker: false,
+    devcontainer: false,
+    license: undefined,
     learning: false,
     template: undefined,
   };
@@ -156,6 +165,9 @@ function parseArgs(argv) {
     else if (a === "--dry-run") out.dryRun = true;
     else if (a === "--ci") out.ci = true;
     else if (a === "--docker") out.docker = true;
+    else if (a === "--devcontainer") out.devcontainer = true;
+    else if (a === "--license") out.license = true;
+    else if (a === "--no-license") out.license = false;
     else if (a === "--learning") out.learning = true;
     else if (a.startsWith("--template="))
       out.template = a.slice("--template=".length);
@@ -190,7 +202,15 @@ function splitCommand(argv) {
   if (!argv || argv.length === 0) return { cmd: "init", rest: [] };
   const first = argv[0];
   if (typeof first === "string" && !first.startsWith("-")) {
-    if (first === "init" || first === "add") {
+    if (
+      first === "init" ||
+      first === "add" ||
+      first === "config" ||
+      first === "doctor" ||
+      first === "upgrade" ||
+      first === "preset" ||
+      first === "plugin"
+    ) {
       return { cmd: first, rest: argv.slice(1) };
     }
   }
@@ -204,11 +224,22 @@ function printHelp() {
   console.log("  projectcli               # init a new project");
   console.log("  projectcli init          # init a new project");
   console.log("  projectcli add           # add libraries to current project");
+  console.log("  projectcli add ci        # add GitHub Actions CI");
+  console.log("  projectcli add docker    # add Dockerfile");
+  console.log("  projectcli add devcontainer # add VS Code devcontainer");
+  console.log("  projectcli add license   # add LICENSE");
+  console.log("  projectcli add lint      # add linter defaults");
+  console.log("  projectcli add test      # add test runner defaults");
+  console.log("  projectcli doctor        # check a repo and optionally fix");
+  console.log("  projectcli preset        # manage presets");
+  console.log("  projectcli upgrade       # upgrade configs safely");
+  console.log("  projectcli plugin        # manage plugins");
   console.log("  projectcli --list        # list all frameworks");
   console.log(
     "  projectcli --language <lang> --framework <fw> --name <project>"
   );
   console.log("  projectcli config        # configure defaults");
+  console.log("  # config files: .projectclirc or projectcli.config.json");
   console.log("");
   console.log("Flags:");
   console.log("  --help, -h       Show help");
@@ -224,8 +255,28 @@ function printHelp() {
   );
   console.log("  --ci             Auto-add GitHub Actions CI");
   console.log("  --docker         Auto-add Dockerfile");
+  console.log("  --devcontainer   Auto-add VS Code Dev Container");
+  console.log("  --license        Force-add LICENSE (uses config defaults)");
+  console.log("  --no-license     Never add LICENSE");
   console.log("  --learning       Enable learning mode (shows descriptions)");
   console.log("  --template       Clone from a Git repository URL");
+  console.log("");
+  console.log("Doctor flags:");
+  console.log("  --fix            Apply safe fixes");
+  console.log("  --json           JSON output (CI-friendly)");
+  console.log("  --ci-only        Only check CI");
+
+  console.log("");
+  console.log("Upgrade flags:");
+  console.log("  --preview        Show what would change");
+  console.log("  --only ci        Upgrade only CI templates");
+  console.log("  --only docker    Upgrade Docker templates");
+  console.log("  --only devcontainer Upgrade devcontainer templates");
+
+  console.log("");
+  console.log("Plugin commands:");
+  console.log("  projectcli plugin list");
+  console.log("  projectcli plugin install <id>");
 }
 
 const BACK = "__back__";
@@ -261,17 +312,47 @@ function printStepsPreview(steps) {
   console.log("");
 }
 
-function printList() {
-  for (const lang of getLanguages()) {
+function filterExistingWriteFiles(steps, projectRoot) {
+  const kept = [];
+  const skipped = [];
+  for (const step of steps || []) {
+    if (step && step.type === "writeFile" && typeof step.path === "string") {
+      const target = path.resolve(projectRoot, step.path);
+      if (fs.existsSync(target)) {
+        skipped.push(step.path);
+        continue;
+      }
+    }
+    kept.push(step);
+  }
+  return { kept, skipped };
+}
+
+function printList(effectiveConfig) {
+  for (const lang of getLanguages(effectiveConfig)) {
     console.log(`${lang}:`);
-    for (const fw of getFrameworks(lang)) {
-      const gen = getGenerator(lang, fw);
+    for (const fw of getFrameworks(lang, effectiveConfig)) {
+      const gen = getGenerator(lang, fw, effectiveConfig);
       const note = gen?.notes ? ` - ${gen.notes}` : "";
-      console.log(`  - ${fw}${note}`);
+      const stability = gen?.stability ? ` [${gen.stability}]` : "";
+      console.log(`  - ${fw}${stability}${note}`);
     }
   }
 }
 
+function formatStabilityBadge(stability) {
+  if (stability === "core") return chalk.green("✅ Core");
+  if (stability === "experimental") return chalk.yellow("⚠ Experimental");
+  if (stability === "community") return chalk.cyan("👥 Community");
+  return null;
+}
+
+function printMissingTool(bin) {
+  console.log(chalk.red(`✖ ${bin} not found`));
+  const hint = getInstallHint(bin);
+  if (hint) console.log(chalk.dim(`  → ${hint}`));
+}
+
 function showBanner() {
   console.log("");
   console.log(
@@ -314,13 +395,20 @@ async function main(options = {}) {
     console.log(readPackageVersion());
     return;
   }
+
+  // Config precedence: CLI args > project config > global config (~/.projectcli.json)
+  const userConfig = loadConfig();
+  const projectConfigInfo = loadProjectConfig(process.cwd());
+  const projectConfig = projectConfigInfo.data || {};
+  const effectiveConfig = { ...userConfig, ...projectConfig };
+
   if (args.list) {
-    printList();
+    printList(effectiveConfig);
     return;
   }
 
   if (cmd === "add") {
-    await runAdd({ prompt, argv: rest });
+    await runAdd({ prompt, argv: rest, effectiveConfig });
     return;
   }
 
@@ -329,6 +417,26 @@ async function main(options = {}) {
     return;
   }
 
+  if (cmd === "doctor") {
+    await runDoctor({ prompt, argv: rest, effectiveConfig });
+    return;
+  }
+
+  if (cmd === "preset") {
+    await runPreset({ prompt, argv: rest, effectiveConfig });
+    return;
+  }
+
+  if (cmd === "upgrade") {
+    await runUpgrade({ prompt, argv: rest });
+    return;
+  }
+
+  if (cmd === "plugin") {
+    await runPlugin({ prompt, argv: rest, effectiveConfig });
+    return;
+  }
+
   // Smart Context Detection
   if (
     cmd === "init" &&
@@ -361,6 +469,8 @@ async function main(options = {}) {
             { name: "Add Library / Dependency", value: "add" },
             { name: "Add GitHub Actions CI", value: "ci" },
             { name: "Add Dockerfile", value: "docker" },
+            { name: "Add Dev Container (VS Code)", value: "devcontainer" },
+            { name: "Add License", value: "license" },
             new inquirer.Separator(),
             { name: "Start New Project Here", value: "new" },
             { name: "Exit", value: "exit" },
@@ -376,20 +486,31 @@ async function main(options = {}) {
         return;
       }
 
-      if (action === "ci" || action === "docker") {
+      if (action === "ci" || action === "docker" || action === "devcontainer") {
         const pm = detectPackageManager(process.cwd());
         let langArg = detected;
         if (detected === "JavaScript/TypeScript") langArg = "JavaScript";
         if (detected === "Java/Kotlin") langArg = "Java";
 
-        const steps =
-          action === "ci"
-            ? generateCI(process.cwd(), langArg, pm)
-            : generateDocker(process.cwd(), langArg);
+        let steps = [];
+        if (action === "ci") steps = generateCI(process.cwd(), langArg, pm);
+        else if (action === "docker")
+          steps = generateDocker(process.cwd(), langArg);
+        else steps = generateDevContainer(process.cwd(), langArg);
+
+        const { kept, skipped } = filterExistingWriteFiles(
+          steps,
+          process.cwd()
+        );
 
-        if (steps.length > 0) {
+        if (kept.length > 0) {
           console.log("\nApplying changes...");
-          await runSteps(steps, { projectRoot: process.cwd() });
+          await runSteps(kept, { projectRoot: process.cwd() });
+          if (skipped.length > 0) {
+            console.log(
+              chalk.dim(`Skipped existing files: ${skipped.join(", ")}`)
+            );
+          }
           console.log(chalk.green("Done!"));
         } else {
           console.log(
@@ -401,6 +522,40 @@ async function main(options = {}) {
         return;
       }
 
+      if (action === "license") {
+        const { type, author } = await prompt([
+          {
+            type: "list",
+            name: "type",
+            message: "Choose a license:",
+            choices: licenseTypes,
+          },
+          {
+            type: "input",
+            name: "author",
+            message: "Author Name:",
+            default: effectiveConfig.author || "The Authors",
+          },
+        ]);
+        const steps = generateLicense(process.cwd(), type, author);
+        const { kept, skipped } = filterExistingWriteFiles(
+          steps,
+          process.cwd()
+        );
+        if (kept.length === 0) {
+          console.log(chalk.dim("Nothing to do (LICENSE already exists)."));
+          return;
+        }
+        await runSteps(kept, { projectRoot: process.cwd() });
+        if (skipped.length > 0) {
+          console.log(
+            chalk.dim(`Skipped existing files: ${skipped.join(", ")}`)
+          );
+        }
+        console.log(chalk.green("Done!"));
+        return;
+      }
+
       // If 'new', fall through to normal wizard
     }
   }
@@ -422,29 +577,80 @@ async function main(options = {}) {
       chalk.dim(" (Type to search)")
   );
 
-  const languages = getLanguages();
+  const languages = getLanguages(effectiveConfig);
   if (languages.length === 0) {
     throw new Error("No languages configured.");
   }
 
-  const userConfig = loadConfig();
-
   const allowedPms = ["npm", "pnpm", "yarn", "bun"];
   let preselectedPm =
     typeof args.pm === "string" && allowedPms.includes(args.pm)
       ? args.pm
       : undefined;
 
-  if (!preselectedPm && userConfig.packageManager) {
-    if (allowedPms.includes(userConfig.packageManager)) {
-      preselectedPm = userConfig.packageManager;
+  const configuredPm =
+    typeof effectiveConfig.packageManager === "string"
+      ? effectiveConfig.packageManager
+      : undefined;
+
+  if (!preselectedPm && configuredPm) {
+    if (allowedPms.includes(configuredPm)) {
+      preselectedPm = configuredPm;
     }
   }
 
-  if (userConfig.learningMode && args.learning === false) {
+  const presetId =
+    typeof effectiveConfig.preset === "string" && effectiveConfig.preset.trim()
+      ? effectiveConfig.preset.trim()
+      : "startup";
+  const preset = getPreset(presetId, effectiveConfig);
+  const presetPm =
+    typeof preset?.defaults?.packageManager === "string"
+      ? preset.defaults.packageManager
+      : null;
+
+  if (!preselectedPm && presetPm && allowedPms.includes(presetPm)) {
+    preselectedPm = presetPm;
+  }
+
+  const learningEnabled =
+    typeof effectiveConfig.learningMode === "boolean"
+      ? effectiveConfig.learningMode
+      : typeof effectiveConfig.learning === "boolean"
+      ? effectiveConfig.learning
+      : false;
+
+  if (learningEnabled && args.learning === false) {
     args.learning = true;
   }
 
+  const defaultLicenseType =
+    typeof effectiveConfig.license === "string" &&
+    licenseTypes.includes(effectiveConfig.license)
+      ? effectiveConfig.license
+      : typeof effectiveConfig.defaultLicense === "string" &&
+        licenseTypes.includes(effectiveConfig.defaultLicense)
+      ? effectiveConfig.defaultLicense
+      : null;
+
+  const defaultAuthor =
+    typeof effectiveConfig.author === "string" && effectiveConfig.author.trim()
+      ? effectiveConfig.author.trim()
+      : "The Authors";
+
+  const defaultCi =
+    typeof effectiveConfig.ci === "boolean"
+      ? effectiveConfig.ci
+      : preset?.defaults?.extras?.ci === true;
+  const defaultDocker =
+    typeof effectiveConfig.docker === "boolean"
+      ? effectiveConfig.docker
+      : preset?.defaults?.extras?.docker === true;
+  const defaultDevContainer =
+    typeof effectiveConfig.devcontainer === "boolean"
+      ? effectiveConfig.devcontainer
+      : preset?.defaults?.extras?.devcontainer === true;
+
   const state = {
     template: args.template || undefined,
     language:
@@ -457,7 +663,10 @@ async function main(options = {}) {
   };
 
   if (state.language) {
-    const frameworksForLanguage = getFrameworks(state.language);
+    const frameworksForLanguage = getFrameworks(
+      state.language,
+      effectiveConfig
+    );
     state.framework =
       args.framework && frameworksForLanguage.includes(args.framework)
         ? args.framework
@@ -480,7 +689,7 @@ async function main(options = {}) {
   while (true) {
     if (step === "language") {
       const languageChoices = languages.map((lang) => {
-        const count = getFrameworks(lang).length;
+        const count = getFrameworks(lang, effectiveConfig).length;
         return { name: `${lang} (${count})`, value: lang, short: lang };
       });
 
@@ -519,15 +728,19 @@ async function main(options = {}) {
     }
 
     if (step === "framework") {
-      const frameworks = getFrameworks(state.language);
+      const frameworks = getFrameworks(state.language, effectiveConfig);
       if (frameworks.length === 0) {
         throw new Error(`No frameworks configured for ${state.language}.`);
       }
 
       const frameworkChoices = frameworks.map((fw) => {
-        const gen = getGenerator(state.language, fw);
+        const gen = getGenerator(state.language, fw, effectiveConfig);
         const note = gen?.notes ? ` — ${gen.notes}` : "";
-        return { name: `${fw}${note}`, value: fw, short: fw };
+        const badge = gen?.stability
+          ? formatStabilityBadge(gen.stability)
+          : null;
+        const badgeText = badge ? ` ${badge}` : "";
+        return { name: `${fw}${badgeText}${note}`, value: fw, short: fw };
       });
 
       const frameworkQuestion = hasAutocomplete
@@ -566,7 +779,11 @@ async function main(options = {}) {
       state.framework = answer.framework;
 
       // Preflight Checks
-      const gen = getGenerator(state.language, state.framework);
+      const gen = getGenerator(
+        state.language,
+        state.framework,
+        effectiveConfig
+      );
       if (gen && gen.check && gen.check.length > 0) {
         /* eslint-disable-next-line no-console */
         console.log(chalk.dim("\n(checking requirements...)"));
@@ -575,7 +792,7 @@ async function main(options = {}) {
 
         if (missing.length > 0) {
           console.log(chalk.red.bold("\nMissing required tools:"));
-          missing.forEach((m) => console.log(chalk.red(` - ${m.bin}`)));
+          missing.forEach((m) => printMissingTool(m.bin));
           console.log(
             chalk.yellow("You may not be able to build or run this project.\n")
           );
@@ -737,6 +954,105 @@ async function main(options = {}) {
           // Remove .git to make it a fresh project
           removeGitFolder(projectRoot);
 
+          // Optional extras after cloning
+          const detectedTemplate = detectLanguage(projectRoot);
+          const pmTemplate = detectPackageManager(projectRoot);
+
+          let langArg = detectedTemplate;
+          if (detectedTemplate === "JavaScript/TypeScript")
+            langArg = "JavaScript";
+          if (detectedTemplate === "Java/Kotlin") langArg = "Java";
+
+          let wantCi = Boolean(args.ci) || defaultCi;
+          let wantDocker = Boolean(args.docker) || defaultDocker;
+          let wantDevContainer =
+            Boolean(args.devcontainer) || defaultDevContainer;
+          let wantLicense =
+            typeof args.license === "boolean"
+              ? args.license
+              : defaultLicenseType !== null;
+
+          if (!args.yes) {
+            const licenseLabel =
+              defaultLicenseType !== null
+                ? `LICENSE (${defaultLicenseType})`
+                : "LICENSE (skip)";
+
+            const { extras } = await prompt([
+              {
+                type: "checkbox",
+                name: "extras",
+                message: "Extras to apply after clone:",
+                choices: [
+                  { name: "GitHub Actions CI", value: "ci", checked: wantCi },
+                  {
+                    name: "Dockerfile",
+                    value: "docker",
+                    checked: wantDocker,
+                  },
+                  {
+                    name: "Dev Container (VS Code)",
+                    value: "devcontainer",
+                    checked: wantDevContainer,
+                  },
+                  {
+                    name: licenseLabel,
+                    value: "license",
+                    checked: wantLicense,
+                    disabled:
+                      defaultLicenseType === null
+                        ? "Configure a default license in 'projectcli config'"
+                        : false,
+                  },
+                ],
+              },
+            ]);
+            if (extras) {
+              wantCi = extras.includes("ci");
+              wantDocker = extras.includes("docker");
+              wantDevContainer = extras.includes("devcontainer");
+              wantLicense = extras.includes("license");
+            }
+          }
+
+          const extraSteps = [];
+          if (wantCi)
+            extraSteps.push(...generateCI(projectRoot, langArg, pmTemplate));
+          if (wantDocker)
+            extraSteps.push(...generateDocker(projectRoot, langArg));
+          if (wantDevContainer) {
+            extraSteps.push(...generateDevContainer(projectRoot, langArg));
+          }
+          if (wantLicense && defaultLicenseType !== null) {
+            extraSteps.push(
+              ...generateLicense(projectRoot, defaultLicenseType, defaultAuthor)
+            );
+          }
+
+          if (wantLicense && defaultLicenseType === null) {
+            console.log(
+              chalk.dim(
+                "Skipping LICENSE (no default license configured; run 'projectcli config')."
+              )
+            );
+          }
+
+          if (extraSteps.length > 0) {
+            const { kept, skipped } = filterExistingWriteFiles(
+              extraSteps,
+              projectRoot
+            );
+            if (kept.length > 0) {
+              console.log(chalk.dim("\nApplying extras..."));
+              await runSteps(kept, { projectRoot });
+            }
+            if (skipped.length > 0) {
+              console.log(
+                chalk.dim(`Skipped existing files: ${skipped.join(", ")}`)
+              );
+            }
+          }
+
           console.log(
             chalk.green(`\nSuccess! Created project at ${projectRoot}`)
           );
@@ -746,7 +1062,14 @@ async function main(options = {}) {
             )
           );
         } catch (err) {
-          console.error(chalk.red("\nFailed to clone template:"), err.message);
+          const message = err && err.message ? err.message : String(err);
+          console.error(chalk.red("\nFailed to clone template:"), message);
+          if (
+            /\bENOENT\b/i.test(message) ||
+            /command not found/i.test(message)
+          ) {
+            printMissingTool("git");
+          }
           process.exit(1);
         }
         return;
@@ -838,6 +1161,11 @@ async function main(options = {}) {
         const message = err && err.message ? err.message : String(err);
         console.error(`\nError: ${message}`);
 
+        const cmdNotFound = /^Command not found:\s*(.+)$/.exec(message);
+        if (cmdNotFound && cmdNotFound[1]) {
+          printMissingTool(cmdNotFound[1].trim());
+        }
+
         const looksLikeNameIssue =
           /cannot be used as a package name|Rust keyword|keyword|Cargo\.toml/i.test(
             message
@@ -921,10 +1249,16 @@ async function main(options = {}) {
         }
       }
 
-      // CI/CD & Docker
+      // CI/CD & Docker & DevContainer
       if (!args.dryRun) {
-        let wantCi = args.ci;
-        let wantDocker = args.docker;
+        let wantCi = Boolean(args.ci) || defaultCi;
+        let wantDocker = Boolean(args.docker) || defaultDocker;
+        let wantDevContainer =
+          Boolean(args.devcontainer) || defaultDevContainer;
+        let wantLicense =
+          typeof args.license === "boolean"
+            ? args.license
+            : defaultLicenseType !== null;
 
         if (!args.yes) {
           const { extras } = await prompt([
@@ -935,12 +1269,31 @@ async function main(options = {}) {
               choices: [
                 { name: "GitHub Actions CI", value: "ci", checked: wantCi },
                 { name: "Dockerfile", value: "docker", checked: wantDocker },
+                {
+                  name: "Dev Container (VS Code)",
+                  value: "devcontainer",
+                  checked: wantDevContainer,
+                },
+                {
+                  name:
+                    defaultLicenseType !== null
+                      ? `LICENSE (${defaultLicenseType})`
+                      : "LICENSE (skip)",
+                  value: "license",
+                  checked: wantLicense,
+                  disabled:
+                    defaultLicenseType === null
+                      ? "Configure a default license in 'projectcli config'"
+                      : false,
+                },
               ],
             },
           ]);
           if (extras) {
             wantCi = extras.includes("ci");
             wantDocker = extras.includes("docker");
+            wantDevContainer = extras.includes("devcontainer");
+            wantLicense = extras.includes("license");
           }
         }
 
@@ -951,10 +1304,28 @@ async function main(options = {}) {
         if (wantDocker) {
           extraSteps.push(...generateDocker(projectRoot, state.language));
         }
+        if (wantDevContainer) {
+          extraSteps.push(...generateDevContainer(projectRoot, state.language));
+        }
+        if (wantLicense && defaultLicenseType !== null) {
+          extraSteps.push(
+            ...generateLicense(projectRoot, defaultLicenseType, defaultAuthor)
+          );
+        }
 
-        if (extraSteps.length > 0) {
+        const { kept, skipped } = filterExistingWriteFiles(
+          extraSteps,
+          projectRoot
+        );
+
+        if (kept.length > 0) {
           console.log("Adding extras...");
-          await runSteps(extraSteps, { projectRoot });
+          await runSteps(kept, { projectRoot });
+        }
+        if (skipped.length > 0) {
+          console.log(
+            chalk.dim(`Skipped existing files: ${skipped.join(", ")}`)
+          );
         }
       }