@jakkrichm/create-nexus-devflow 2.9.0 → 2.9.4

package/dist/bin/create-nexus-devflow.d.ts

@@ -4,7 +4,7 @@ import { type SliceStage } from "../lib/context-slicer.js";
 import { type GitHookType } from "../lib/git-hooks.js";
 interface CliOptions {
     command: "dashboard" | "install" | "status" | "ui" | "update" | "uninstall" | "eject" | "idea" | "ideas" | "findings" | "doctor" | "archive" | "check-gate" | "hook" | "mcp" | "slice" | "drift" | "reconcile" | "studio" | "swarm" | "graph" | "skill" | "skills";
-    subcommandAction?: "add" | "list" | "resolve" | "stats" | "install" | "uninstall" | "remove" | "sync";
+    subcommandAction?: "add" | "list" | "resolve" | "stats" | "install" | "uninstall" | "remove" | "sync" | "update" | "upgrade";
     subcommandArg?: string;
     graphFile?: string;
     sliceStage?: SliceStage;
@@ -17,6 +17,9 @@ interface CliOptions {
     findingLocation?: string;
     findingImpact?: string;
     findingRemediation?: string;
+    skillName?: string;
+    installAllSkills: boolean;
+    recommended: boolean;
     blockersOnly: boolean;
     fix: boolean;
     statsOnly: boolean;
@@ -35,4 +38,6 @@ interface CliOptions {
 }
 declare function main(args?: readonly string[]): Promise<void>;
 declare function parseArgs(args: readonly string[]): CliOptions;
-export { main, parseArgs };
+declare function findPackageRoot(startDir: string): string;
+declare function formatMissingTemplateMessage(templateRoot: string): string;
+export { findPackageRoot, formatMissingTemplateMessage, main, parseArgs };

package/dist/bin/create-nexus-devflow.js

@@ -20,11 +20,9 @@ import { installGitHook, uninstallGitHooks } from "../lib/git-hooks.js";
 import { createSpinner, createStyle } from "../lib/ui.js";
 import { applyPreparedUpdate, prepareUpdate } from "../lib/update.js";
 import { applyUninstall, prepareUninstall } from "../lib/uninstall.js";
-import { installThirdPartySkill, listInstalledSkills, removeThirdPartySkill, syncSkills } from "../lib/skill-manager.js";
+import { installRecommendedSkills, installThirdPartySkill, listInstalledSkills, removeThirdPartySkill, syncSkills, updateRecommendedSkills, updateThirdPartySkills } from "../lib/skill-manager.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const packageRoot = fsSync.existsSync(path.join(__dirname, "..", "package.json"))
-    ? path.resolve(__dirname, "..")
-    : path.resolve(__dirname, "..", "..");
+const packageRoot = findPackageRoot(__dirname);
 const templateRoot = path.join(packageRoot, "template");
 const adapterChoices = new Set(["codex", "antigravity", "claude", "copilot", "opencode", "both", "all"]);
 async function main(args = process.argv.slice(2)) {
@@ -235,28 +233,75 @@ async function main(args = process.argv.slice(2)) {
     if (options.command === "skill" || options.command === "skills") {
         const style = createStyle(shouldUseColor());
         if (options.subcommandAction === "add" || options.subcommandAction === "install") {
+            if (options.recommended || options.subcommandArg === "recommended" || options.subcommandArg === "--recommended") {
+                const spinner = createSpinner("Installing recommended third-party skills (8 skills from 3 repositories)...").start();
+                try {
+                    const detail = await installRecommendedSkills(targetDir, { force: options.force });
+                    spinner.succeed(`Successfully installed ${detail.length} recommended third-party skill(s): ${detail.map((d) => style.bold(style.cyan(d.name))).join(", ")}`);
+                    if (options.json) {
+                        console.log(JSON.stringify(detail, null, 2));
+                    }
+                    else {
+                        for (const d of detail) {
+                            console.log(`\n  ${style.dim("Name    :")} ${style.bold(d.name)}`);
+                            if (d.version)
+                                console.log(`  ${style.dim("Version :")} ${d.version}`);
+                            if (d.description)
+                                console.log(`  ${style.dim("Desc    :")} ${d.description}`);
+                            console.log(`  ${style.dim("Adapters:")} ${d.adapters.join(", ")}`);
+                        }
+                        console.log(`\n${style.green("✔")} All ${detail.length} recommended skills ready to use! Invocable as /<skill-name> in workflows.`);
+                    }
+                }
+                catch (err) {
+                    spinner.fail(`Failed to install recommended skills: ${err instanceof Error ? err.message : String(err)}`);
+                    process.exitCode = 1;
+                }
+                return;
+            }
             const source = options.subcommandArg || "";
             if (!source.trim()) {
-                throw new Error("Skill source (Git URL or local directory) is required. Example: nexus-devflow skill add https://github.com/cathrynlavery/diagram-design");
+                throw new Error("Skill source (Git URL or local directory) is required. Example: nexus-devflow skill add https://github.com/cathrynlavery/diagram-design or nexus-devflow skill add --recommended");
             }
             const spinner = createSpinner(`Installing skill from ${source}...`).start();
             try {
                 const detail = await installThirdPartySkill(targetDir, source, {
+                    name: options.skillName,
+                    all: options.installAllSkills,
                     force: options.force
                 });
-                spinner.succeed(`Successfully installed third-party skill: ${style.bold(style.cyan(detail.name))}`);
-                if (options.json) {
-                    console.log(JSON.stringify(detail, null, 2));
+                if (Array.isArray(detail)) {
+                    spinner.succeed(`Successfully installed ${detail.length} third-party skill(s): ${detail.map((d) => style.bold(style.cyan(d.name))).join(", ")}`);
+                    if (options.json) {
+                        console.log(JSON.stringify(detail, null, 2));
+                    }
+                    else {
+                        for (const d of detail) {
+                            console.log(`\n  ${style.dim("Name    :")} ${style.bold(d.name)}`);
+                            if (d.version)
+                                console.log(`  ${style.dim("Version :")} ${d.version}`);
+                            if (d.description)
+                                console.log(`  ${style.dim("Desc    :")} ${d.description}`);
+                            console.log(`  ${style.dim("Adapters:")} ${d.adapters.join(", ")}`);
+                        }
+                        console.log(`\n${style.green("✔")} All ${detail.length} skills ready to use! Invocable as /<skill-name> in workflows.`);
+                    }
                 }
                 else {
-                    console.log(`\n  ${style.dim("Name    :")} ${style.bold(detail.name)}`);
-                    if (detail.version)
-                        console.log(`  ${style.dim("Version :")} ${detail.version}`);
-                    if (detail.description)
-                        console.log(`  ${style.dim("Desc    :")} ${detail.description}`);
-                    console.log(`  ${style.dim("Source  :")} ${detail.source}`);
-                    console.log(`  ${style.dim("Adapters:")} ${detail.adapters.join(", ")}`);
-                    console.log(`\n${style.green("✔")} Skill ready to use! Invocable as ${style.cyan(`/${detail.name}`)} or inside /discovery, /feature, /brainstorm.`);
+                    spinner.succeed(`Successfully installed third-party skill: ${style.bold(style.cyan(detail.name))}`);
+                    if (options.json) {
+                        console.log(JSON.stringify(detail, null, 2));
+                    }
+                    else {
+                        console.log(`\n  ${style.dim("Name    :")} ${style.bold(detail.name)}`);
+                        if (detail.version)
+                            console.log(`  ${style.dim("Version :")} ${detail.version}`);
+                        if (detail.description)
+                            console.log(`  ${style.dim("Desc    :")} ${detail.description}`);
+                        console.log(`  ${style.dim("Source  :")} ${detail.source}`);
+                        console.log(`  ${style.dim("Adapters:")} ${detail.adapters.join(", ")}`);
+                        console.log(`\n${style.green("✔")} Skill ready to use! Invocable as ${style.cyan(`/${detail.name}`)} or inside /discovery, /feature, /brainstorm.`);
+                    }
                 }
             }
             catch (err) {
@@ -298,6 +343,77 @@ async function main(args = process.argv.slice(2)) {
             }
             return;
         }
+        if (options.subcommandAction === "update" || options.subcommandAction === "upgrade") {
+            if (options.recommended || options.subcommandArg === "recommended" || options.subcommandArg === "--recommended") {
+                const spinner = createSpinner("Updating recommended third-party skills from latest upstream repositories...").start();
+                try {
+                    const result = await updateRecommendedSkills(targetDir);
+                    if (result.totalUpdated === 0 && result.failedSkills.length === 0) {
+                        spinner.succeed("No recommended third-party skills installed to update.");
+                    }
+                    else if (result.failedSkills.length > 0 && result.totalUpdated === 0) {
+                        spinner.fail(`Failed to update recommended skills: ${result.failedSkills.map((f) => `${f.name} (${f.reason})`).join(", ")}`);
+                        process.exitCode = 1;
+                    }
+                    else {
+                        spinner.succeed(`Successfully updated ${result.totalUpdated} recommended third-party skill(s): ${result.updatedSkills.map((s) => style.bold(style.cyan(s.name))).join(", ")}`);
+                        if (options.json) {
+                            console.log(JSON.stringify(result, null, 2));
+                        }
+                        else {
+                            for (const d of result.updatedSkills) {
+                                console.log(`  ✔ ${style.bold(style.cyan(d.name))} ${d.version ? `v${d.version}` : ""}`);
+                            }
+                            if (result.failedSkills.length > 0) {
+                                console.log(`\n${style.yellow("⚠")} Failed to update (${result.failedSkills.length}):`);
+                                for (const f of result.failedSkills) {
+                                    console.log(`  ✖ ${style.red(f.name)}: ${f.reason}`);
+                                }
+                            }
+                        }
+                    }
+                }
+                catch (err) {
+                    spinner.fail(`Failed to update recommended skills: ${err instanceof Error ? err.message : String(err)}`);
+                    process.exitCode = 1;
+                }
+                return;
+            }
+            const targetSkill = options.subcommandArg || (options.installAllSkills ? "--all" : undefined);
+            const spinner = createSpinner(targetSkill && targetSkill !== "--all" ? `Updating skill ${targetSkill}...` : "Updating third-party skills...").start();
+            try {
+                const result = await updateThirdPartySkills(targetDir, targetSkill);
+                if (result.totalUpdated === 0 && result.failedSkills.length === 0) {
+                    spinner.succeed("No third-party skills installed to update.");
+                }
+                else if (result.failedSkills.length > 0 && result.totalUpdated === 0) {
+                    spinner.fail(`Failed to update skills: ${result.failedSkills.map((f) => `${f.name} (${f.reason})`).join(", ")}`);
+                    process.exitCode = 1;
+                }
+                else {
+                    spinner.succeed(`Successfully updated ${result.totalUpdated} third-party skill(s): ${result.updatedSkills.map((s) => style.bold(style.cyan(s.name))).join(", ")}`);
+                    if (options.json) {
+                        console.log(JSON.stringify(result, null, 2));
+                    }
+                    else {
+                        for (const d of result.updatedSkills) {
+                            console.log(`  ✔ ${style.bold(style.cyan(d.name))} ${d.version ? `v${d.version}` : ""}`);
+                        }
+                        if (result.failedSkills.length > 0) {
+                            console.log(`\n${style.yellow("⚠")} Failed to update (${result.failedSkills.length}):`);
+                            for (const f of result.failedSkills) {
+                                console.log(`  ✖ ${style.red(f.name)}: ${f.reason}`);
+                            }
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                spinner.fail(`Failed to update skills: ${err instanceof Error ? err.message : String(err)}`);
+                process.exitCode = 1;
+            }
+            return;
+        }
         // Default: list
         const result = await listInstalledSkills(targetDir);
         if (options.json) {
@@ -561,6 +677,9 @@ function parseArgs(args) {
     let findingLocation;
     let findingImpact;
     let findingRemediation;
+    let skillName;
+    let installAllSkills = false;
+    let recommended = false;
     let blockersOnly = false;
     let fix = false;
     let statsOnly = false;
@@ -790,8 +909,38 @@ function parseArgs(args) {
             adapter = "opencode";
             continue;
         }
+        if (arg === "--name" || arg === "-n") {
+            const next = args[++i];
+            if (!next) {
+                throw new Error(`${arg} requires a skill name`);
+            }
+            skillName = next;
+            continue;
+        }
+        if (arg.startsWith("--name=")) {
+            skillName = arg.slice("--name=".length);
+            continue;
+        }
+        if (arg === "--all-skills") {
+            installAllSkills = true;
+            continue;
+        }
+        if (arg === "--recommended") {
+            recommended = true;
+            continue;
+        }
+        if (arg === "--preset=recommended") {
+            recommended = true;
+            continue;
+        }
+        if (arg === "--preset" && args[i + 1] === "recommended") {
+            recommended = true;
+            i++;
+            continue;
+        }
         if (arg === "--all" || arg === "--both") {
             adapter = "all";
+            installAllSkills = true;
             continue;
         }
         if (arg.startsWith("-")) {
@@ -961,8 +1110,19 @@ function parseArgs(args) {
             command = "skill";
             if (positional[1] === "add" || positional[1] === "install") {
                 subcommandAction = "add";
-                subcommandArg = positional[2];
-                target = positional[3] || target || ".";
+                if (positional[2] === "--recommended" || positional[2] === "recommended") {
+                    recommended = true;
+                    target = positional[3] || target || ".";
+                }
+                else {
+                    subcommandArg = positional[2];
+                    target = positional[3] || target || ".";
+                }
+            }
+            else if (positional[1] === "add-recommended" || positional[1] === "install-recommended") {
+                subcommandAction = "add";
+                recommended = true;
+                target = positional[2] || target || ".";
             }
             else if (positional[1] === "remove" || positional[1] === "uninstall" || positional[1] === "rm") {
                 subcommandAction = "remove";
@@ -973,14 +1133,36 @@ function parseArgs(args) {
                 subcommandAction = "sync";
                 target = positional[2] || target || ".";
             }
+            else if (positional[1] === "update" || positional[1] === "upgrade") {
+                subcommandAction = "update";
+                if (positional[2] === "--recommended" || positional[2] === "recommended") {
+                    recommended = true;
+                    target = positional[3] || target || ".";
+                }
+                else {
+                    subcommandArg = positional[2];
+                    target = positional[3] || target || ".";
+                }
+            }
+            else if (positional[1] === "update-recommended" || positional[1] === "upgrade-recommended") {
+                subcommandAction = "update";
+                recommended = true;
+                target = positional[2] || target || ".";
+            }
             else if (positional[1] === "list" || positional[1] === "ls") {
                 subcommandAction = "list";
                 target = positional[2] || target || ".";
             }
             else if (positional[1] && !positional[1].startsWith("-")) {
                 subcommandAction = "add";
-                subcommandArg = positional[1];
-                target = positional[2] || target || ".";
+                if (positional[1] === "recommended") {
+                    recommended = true;
+                    target = positional[2] || target || ".";
+                }
+                else {
+                    subcommandArg = positional[1];
+                    target = positional[2] || target || ".";
+                }
             }
             else {
                 subcommandAction = "list";
@@ -1010,6 +1192,9 @@ function parseArgs(args) {
         findingLocation,
         findingImpact,
         findingRemediation,
+        skillName,
+        installAllSkills,
+        recommended,
         blockersOnly,
         fix,
         statsOnly,
@@ -1071,7 +1256,8 @@ ${style.bold("Usage:")}
   ${style.cyan("nexus-devflow findings resolve")} <ID> [--status <status>]
   ${style.cyan("nexus-devflow doctor")} [--fix] [--json]
   ${style.cyan("nexus-devflow skill")} [list] [--json]
-  ${style.cyan("nexus-devflow skill add")} <git-url-or-path> [--force]
+  ${style.cyan("nexus-devflow skill add")} <git-url-or-path|--recommended> [--name <name>] [--all] [--force]
+  ${style.cyan("nexus-devflow skill update")} [name|--all|--recommended]
   ${style.cyan("nexus-devflow skill remove")} <name>
   ${style.cyan("nexus-devflow skill sync")}
   ${style.cyan("nexus-devflow archive")} [list|stats] [--json]
@@ -1089,14 +1275,17 @@ ${style.bold("Commands:")}
   ${style.brightCyan("idea, ideas")}        Manage idea backlog: add new ideas or list pending ideas
   ${style.brightCyan("findings")}           Inspect findings ledger, record new findings, filter blockers, or resolve
   ${style.brightCyan("doctor")}             Inspect project workspace health and auto-heal missing files (--fix)
-  ${style.brightCyan("skill, skills")}      Manage third-party skills: add from Git/local, remove, sync, or list
+  ${style.brightCyan("skill, skills")}      Manage third-party skills: add from Git/local/preset, update, remove, sync, or list
   ${style.brightCyan("archive")}            Explore delivered runs and release statistics from devflow/history/
   ${style.brightCyan("update")}             Update existing DevFlow installation without overwriting user changes
   ${style.brightCyan("uninstall, eject")}   Completely remove DevFlow workflow files and adapters from project
 
 ${style.bold("Options:")}
+  ${style.cyan("--recommended")}      Install or update all recommended community skills (archify, diagram-design, 9arm-skills)
   ${style.cyan("--strict")}           Strict mode for check-gate (blocks unverified runs)
   ${style.cyan("--title <text>")}     Custom title for idea add
+  ${style.cyan("--name <skill-name>")} Target specific skill in a multi-skill repository
+  ${style.cyan("--all, --all-skills")} Install all skills from a multi-skill repository
   ${style.cyan("--severity, -s")}     Finding severity: P0, P1, P2, P3 (default: P2)
   ${style.cyan("--status <name>")}    Status to set when resolving finding (default: closed)
   ${style.cyan("--location <path>")}  Finding source code file and line location
@@ -1206,6 +1395,25 @@ function printUninstallSuccess(result) {
     console.log(`\n${style.green("✔")} ${style.bold("Nexus-DevFlow has been completely removed from the project.")}`);
     console.log(`  ${style.dim("Deleted")} ${style.bold(String(result.deletedCount))} item(s). No DevFlow traces remain.`);
 }
+function findPackageRoot(startDir) {
+    let current = startDir;
+    for (;;) {
+        if (fsSync.existsSync(path.join(current, "package.json"))) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            throw new Error(`Could not locate the installer package root above ${startDir}.`);
+        }
+        current = parent;
+    }
+}
+function formatMissingTemplateMessage(templateRoot) {
+    return `Installer template is missing.
+Looked in: ${templateRoot}
+This looks like a source checkout, where the template is a build artifact.
+Run \`npm run link:local\` from the repository root, or \`npm run prepare-template\` inside the installer package.`;
+}
 if (process.argv[1] &&
     fsSync.realpathSync(process.argv[1]) === fsSync.realpathSync(fileURLToPath(import.meta.url))) {
     main().catch((err) => {
@@ -1213,5 +1421,5 @@ if (process.argv[1] &&
         process.exit(1);
     });
 }
-export { main, parseArgs };
+export { findPackageRoot, formatMissingTemplateMessage, main, parseArgs };
 //# sourceMappingURL=create-nexus-devflow.js.map