@jakkrichm/create-nexus-devflow 2.9.0 → 2.9.3

package/dist/lib/run-state.js

@@ -0,0 +1,203 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+const RUN_STATE_PATH = path.join("devflow", ".state", "run.json");
+const COMMAND_PATTERN = /^[a-z][a-z-]{0,31}$/;
+const RUN_STATUSES = new Set([
+    "running",
+    "blocked",
+    "ready",
+    "completed"
+]);
+const RUN_BOUNDARIES = new Set([
+    "read-only",
+    "reviewed",
+    "local-only"
+]);
+const RUN_STALE_AFTER_MS = 60 * 60 * 1000;
+async function readRunState(projectRoot, now = new Date()) {
+    const runStatePath = path.join(projectRoot, RUN_STATE_PATH);
+    try {
+        const stats = await fs.lstat(runStatePath);
+        if (stats.isSymbolicLink()) {
+            return malformedSummary({
+                code: "unsafe_run_state_path",
+                message: "Dashboard run state is a symbolic link and was not read."
+            });
+        }
+        if (!stats.isFile()) {
+            return malformedSummary({
+                code: "invalid_run_state_path",
+                message: "Dashboard run state path is not a regular file."
+            });
+        }
+        return parseRunState(await fs.readFile(runStatePath, "utf8"), now);
+    }
+    catch (error) {
+        if (getErrorCode(error) === "ENOENT") {
+            return idleSummary();
+        }
+        throw error;
+    }
+}
+function parseRunState(value, now = new Date()) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        return malformedSummary({
+            code: "malformed_run_state",
+            message: "Dashboard run state is not valid JSON."
+        });
+    }
+    if (!isRecord(parsed)) {
+        return malformedRunState();
+    }
+    const command = readString(parsed.command);
+    const status = readString(parsed.status);
+    const summary = readString(parsed.summary);
+    const detail = readOptionalString(parsed.detail);
+    const boundary = readOptionalString(parsed.boundary);
+    const startedAt = readString(parsed.startedAt);
+    const updatedAt = readString(parsed.updatedAt);
+    const resumeCommand = readOptionalString(parsed.resumeCommand);
+    const progress = parseProgress(parsed.progress);
+    const feature = parseFeature(parsed.feature);
+    if (parsed.schemaVersion !== 1 ||
+        !command ||
+        !COMMAND_PATTERN.test(command) ||
+        !status ||
+        !RUN_STATUSES.has(status) ||
+        !summary ||
+        !startedAt ||
+        !updatedAt ||
+        !isTimestamp(startedAt) ||
+        !isTimestamp(updatedAt) ||
+        Date.parse(startedAt) > Date.parse(updatedAt) ||
+        (parsed.detail !== undefined && detail === null) ||
+        (parsed.boundary !== undefined && (!boundary || !RUN_BOUNDARIES.has(boundary))) ||
+        (parsed.resumeCommand !== undefined && resumeCommand === null) ||
+        (parsed.progress !== undefined && progress === null) ||
+        (parsed.feature !== undefined && feature === null)) {
+        return malformedRunState();
+    }
+    const freshness = status === "running" &&
+        now.getTime() - Date.parse(updatedAt) > RUN_STALE_AFTER_MS
+        ? "stale"
+        : "current";
+    const warnings = freshness === "stale"
+        ? [
+            {
+                code: "stale_run_state",
+                message: `Recorded /${command} activity has not updated for over one hour and may have been interrupted.`
+            }
+        ]
+        : [];
+    return {
+        state: "recorded",
+        mode: command === "autopilot"
+            ? "autopilot"
+            : command === "continuous"
+                ? "continuous"
+                : "manual",
+        command,
+        status,
+        freshness,
+        summary,
+        detail,
+        boundary,
+        startedAt,
+        updatedAt,
+        resumeCommand,
+        progress,
+        feature,
+        warnings
+    };
+}
+function parseProgress(value) {
+    if (value === undefined) {
+        return null;
+    }
+    if (!isRecord(value)) {
+        return null;
+    }
+    const label = readString(value.label);
+    const current = value.current;
+    const total = value.total;
+    if (!label ||
+        !Number.isInteger(current) ||
+        !Number.isInteger(total) ||
+        Number(current) < 0 ||
+        Number(total) < 1 ||
+        Number(current) > Number(total)) {
+        return null;
+    }
+    return { label, current: Number(current), total: Number(total) };
+}
+function parseFeature(value) {
+    if (value === undefined) {
+        return null;
+    }
+    if (!isRecord(value)) {
+        return null;
+    }
+    const id = readOptionalString(value.id);
+    const title = readString(value.title);
+    if (!title || (value.id !== undefined && id === null)) {
+        return null;
+    }
+    return { id, title };
+}
+function malformedRunState() {
+    return malformedSummary({
+        code: "malformed_run_state",
+        message: "Dashboard run state does not match schema version 1."
+    });
+}
+function idleSummary() {
+    return {
+        state: "idle",
+        mode: "manual",
+        command: null,
+        status: null,
+        freshness: null,
+        summary: null,
+        detail: null,
+        boundary: null,
+        startedAt: null,
+        updatedAt: null,
+        resumeCommand: null,
+        progress: null,
+        feature: null,
+        warnings: []
+    };
+}
+function malformedSummary(warning) {
+    return {
+        ...idleSummary(),
+        state: "malformed",
+        warnings: [warning]
+    };
+}
+function readString(value) {
+    return typeof value === "string" && value.trim() !== "" ? value.trim() : null;
+}
+function readOptionalString(value) {
+    return value === undefined ? null : readString(value);
+}
+function isTimestamp(value) {
+    return !Number.isNaN(Date.parse(value));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function getErrorCode(error) {
+    return typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        typeof error.code === "string"
+        ? error.code
+        : undefined;
+}
+export { RUN_STATE_PATH, parseRunState, readRunState };
+//# sourceMappingURL=run-state.js.map

package/dist/lib/run-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-state.js","sourceRoot":"","sources":["../../lib/run-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AA6C7B,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AAClE,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAC9C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAY;IACtC,SAAS;IACT,SAAS;IACT,OAAO;IACP,WAAW;CACZ,CAAC,CAAC;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAc;IAC1C,WAAW;IACX,UAAU;IACV,YAAY;CACb,CAAC,CAAC;AACH,MAAM,kBAAkB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE1C,KAAK,UAAU,YAAY,CACzB,WAAmB,EACnB,MAAY,IAAI,IAAI,EAAE;IAEtB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAE5D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAE3C,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;YAC3B,OAAO,gBAAgB,CAAC;gBACtB,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE,0DAA0D;aACpE,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACpB,OAAO,gBAAgB,CAAC;gBACtB,IAAI,EAAE,wBAAwB;gBAC9B,OAAO,EAAE,iDAAiD;aAC3D,CAAC,CAAC;QACL,CAAC;QAED,OAAO,aAAa,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;IACrE,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,YAAY,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;YACrC,OAAO,WAAW,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAa,EAAE,MAAY,IAAI,IAAI,EAAE;IAC1D,IAAI,MAAe,CAAC;IAEpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,gBAAgB,CAAC;YACtB,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,wCAAwC;SAClD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,iBAAiB,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAqB,CAAC;IAC7D,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAuB,CAAC;IAC3E,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,kBAAkB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE7C,IACE,MAAM,CAAC,aAAa,KAAK,CAAC;QAC1B,CAAC,OAAO;QACR,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;QAC9B,CAAC,MAAM;QACP,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC;QACzB,CAAC,OAAO;QACR,CAAC,SAAS;QACV,CAAC,SAAS;QACV,CAAC,WAAW,CAAC,SAAS,CAAC;QACvB,CAAC,WAAW,CAAC,SAAS,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;QAC7C,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,CAAC;QAChD,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/E,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,IAAI,aAAa,KAAK,IAAI,CAAC;QAC9D,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,CAAC;QACpD,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,CAAC,EAClD,CAAC;QACD,OAAO,iBAAiB,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,SAAS,GACb,MAAM,KAAK,SAAS;QACpB,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,kBAAkB;QACxD,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,QAAQ,GACZ,SAAS,KAAK,OAAO;QACnB,CAAC,CAAC;YACE;gBACE,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,aAAa,OAAO,4EAA4E;aAC1G;SACF;QACH,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;QACL,KAAK,EAAE,UAAU;QACjB,IAAI,EACF,OAAO,KAAK,WAAW;YACrB,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,OAAO,KAAK,YAAY;gBAC1B,CAAC,CAAC,YAAY;gBACd,CAAC,CAAC,QAAQ;QACd,OAAO;QACP,MAAM;QACN,SAAS;QACT,OAAO;QACP,MAAM;QACN,QAAQ;QACR,SAAS;QACT,SAAS;QACT,aAAa;QACb,QAAQ;QACR,OAAO;QACP,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAE1B,IACE,CAAC,KAAK;QACN,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC;QAC1B,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;QACxB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;QACnB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QACjB,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,EAC/B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEtC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AACvB,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO,gBAAgB,CAAC;QACtB,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,sDAAsD;KAChE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW;IAClB,OAAO;QACL,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,IAAI;QACnB,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAwB;IAChD,OAAO;QACL,GAAG,WAAW,EAAE;QAChB,KAAK,EAAE,WAAW;QAClB,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAChF,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ;QAC9B,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,CAAC,CAAC,KAAK,CAAC,IAAI;QACZ,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC"}

package/dist/lib/skill-manager.d.ts

@@ -23,7 +23,9 @@ export interface SkillListResult {
 }
 export interface InstallSkillOptions {
     name?: string;
+    all?: boolean;
     force?: boolean;
+    overrideSource?: string;
 }
 export declare function parseSkillFrontmatter(content: string): {
     name?: string;
@@ -33,6 +35,16 @@ export declare function parseSkillFrontmatter(content: string): {
 export declare function readDevflowManifest(projectRoot: string): Promise<Record<string, unknown> | null>;
 export declare function writeDevflowManifest(projectRoot: string, manifest: Record<string, unknown>): Promise<void>;
 export declare function listInstalledSkills(projectRoot: string): Promise<SkillListResult>;
+export interface DiscoveredSkill {
+    sourceSkillPath: string;
+    skillName: string;
+    meta: {
+        name?: string;
+        description?: string;
+        version?: string;
+    };
+}
+export declare function discoverSkillsInDirectory(rootDir: string, maxDepth?: number, currentDepth?: number): Promise<DiscoveredSkill[]>;
 export declare function findSkillSourceDirectory(sourceDir: string, requestedName?: string): Promise<{
     sourceSkillPath: string;
     skillName: string;
@@ -42,9 +54,20 @@ export declare function findSkillSourceDirectory(sourceDir: string, requestedNam
         version?: string;
     };
 }>;
-export declare function installThirdPartySkill(projectRoot: string, source: string, options?: InstallSkillOptions): Promise<SkillDetail>;
+export declare function installThirdPartySkill(projectRoot: string, source: string, options?: InstallSkillOptions): Promise<SkillDetail | SkillDetail[]>;
 export declare function removeThirdPartySkill(projectRoot: string, name: string): Promise<boolean>;
 export declare function syncSkills(projectRoot: string): Promise<{
     syncedCount: number;
     skills: string[];
 }>;
+export interface SkillUpdateResult {
+    updatedSkills: SkillDetail[];
+    failedSkills: Array<{
+        name: string;
+        reason: string;
+    }>;
+    totalUpdated: number;
+}
+export declare function updateThirdPartySkills(projectRoot: string, targetSkillName?: string, options?: {
+    force?: boolean;
+}): Promise<SkillUpdateResult>;

package/dist/lib/skill-manager.js

@@ -156,76 +156,80 @@ export async function listInstalledSkills(projectRoot) {
         totalCount: coreSkills.length + thirdPartySkills.length
     };
 }
-export async function findSkillSourceDirectory(sourceDir, requestedName) {
-    // Check 1: If sourceDir itself has SKILL.md
-    const rootSkillMd = path.join(sourceDir, "SKILL.md");
-    if (fsSync.existsSync(rootSkillMd)) {
-        const content = await fs.readFile(rootSkillMd, "utf8");
-        const meta = parseSkillFrontmatter(content);
-        const skillName = requestedName || meta.name || path.basename(sourceDir);
-        return { sourceSkillPath: sourceDir, skillName, meta };
-    }
-    // Check 2: Check inside skills/ subfolder
-    const skillsSubDir = path.join(sourceDir, "skills");
-    if (fsSync.existsSync(skillsSubDir)) {
-        const entries = await fs.readdir(skillsSubDir, { withFileTypes: true });
-        const skillDirs = entries.filter((e) => e.isDirectory());
-        if (requestedName) {
-            const targetDir = path.join(skillsSubDir, requestedName);
-            if (fsSync.existsSync(path.join(targetDir, "SKILL.md"))) {
-                const content = await fs.readFile(path.join(targetDir, "SKILL.md"), "utf8");
-                const meta = parseSkillFrontmatter(content);
-                return { sourceSkillPath: targetDir, skillName: requestedName, meta };
-            }
-        }
-        if (skillDirs.length === 1) {
-            const onlyDir = skillDirs[0].name;
-            const targetDir = path.join(skillsSubDir, onlyDir);
-            if (fsSync.existsSync(path.join(targetDir, "SKILL.md"))) {
-                const content = await fs.readFile(path.join(targetDir, "SKILL.md"), "utf8");
-                const meta = parseSkillFrontmatter(content);
-                return { sourceSkillPath: targetDir, skillName: requestedName || meta.name || onlyDir, meta };
-            }
+export async function discoverSkillsInDirectory(rootDir, maxDepth = 5, currentDepth = 0) {
+    const results = [];
+    if (currentDepth > maxDepth)
+        return results;
+    const skillMdPath = path.join(rootDir, "SKILL.md");
+    if (fsSync.existsSync(skillMdPath)) {
+        try {
+            const content = await fs.readFile(skillMdPath, "utf8");
+            const meta = parseSkillFrontmatter(content);
+            const skillName = meta.name || path.basename(rootDir);
+            results.push({
+                sourceSkillPath: rootDir,
+                skillName,
+                meta
+            });
+            return results;
         }
-        if (skillDirs.length > 1) {
-            // If one matches the requested name or base name of source
-            const baseName = path.basename(sourceDir);
-            for (const dir of skillDirs) {
-                if (dir.name === requestedName || dir.name === baseName) {
-                    const targetDir = path.join(skillsSubDir, dir.name);
-                    if (fsSync.existsSync(path.join(targetDir, "SKILL.md"))) {
-                        const content = await fs.readFile(path.join(targetDir, "SKILL.md"), "utf8");
-                        const meta = parseSkillFrontmatter(content);
-                        return { sourceSkillPath: targetDir, skillName: dir.name, meta };
-                    }
-                }
-            }
+        catch {
+            // ignore read error
         }
     }
-    // Check 3: Check .agents/skills subfolder
-    const dotAgentsSkills = path.join(sourceDir, ".agents", "skills");
-    if (fsSync.existsSync(dotAgentsSkills)) {
-        const entries = await fs.readdir(dotAgentsSkills, { withFileTypes: true });
-        const skillDirs = entries.filter((e) => e.isDirectory());
-        if (requestedName) {
-            const targetDir = path.join(dotAgentsSkills, requestedName);
-            if (fsSync.existsSync(path.join(targetDir, "SKILL.md"))) {
-                const content = await fs.readFile(path.join(targetDir, "SKILL.md"), "utf8");
-                const meta = parseSkillFrontmatter(content);
-                return { sourceSkillPath: targetDir, skillName: requestedName, meta };
-            }
+    let entries;
+    try {
+        entries = await fs.readdir(rootDir, { withFileTypes: true });
+    }
+    catch {
+        return results;
+    }
+    const IGNORED_DIRS = new Set([".git", "node_modules", "dist", ".nexus", "build", "coverage", ".turbo"]);
+    for (const entry of entries) {
+        if (entry.isDirectory() && !IGNORED_DIRS.has(entry.name)) {
+            const subDir = path.join(rootDir, entry.name);
+            const subResults = await discoverSkillsInDirectory(subDir, maxDepth, currentDepth + 1);
+            results.push(...subResults);
         }
-        if (skillDirs.length === 1) {
-            const onlyDir = skillDirs[0].name;
-            const targetDir = path.join(dotAgentsSkills, onlyDir);
-            if (fsSync.existsSync(path.join(targetDir, "SKILL.md"))) {
-                const content = await fs.readFile(path.join(targetDir, "SKILL.md"), "utf8");
-                const meta = parseSkillFrontmatter(content);
-                return { sourceSkillPath: targetDir, skillName: requestedName || meta.name || onlyDir, meta };
-            }
+    }
+    return results;
+}
+export async function findSkillSourceDirectory(sourceDir, requestedName) {
+    const discovered = await discoverSkillsInDirectory(sourceDir);
+    if (discovered.length === 0) {
+        throw new Error(`Could not find any valid skill with SKILL.md in source: ${sourceDir}`);
+    }
+    if (requestedName) {
+        const match = discovered.find((s) => s.skillName === requestedName || path.basename(s.sourceSkillPath) === requestedName);
+        if (match) {
+            return {
+                sourceSkillPath: match.sourceSkillPath,
+                skillName: requestedName,
+                meta: match.meta
+            };
         }
+        const available = discovered.map((s) => s.skillName).join(", ");
+        throw new Error(`Skill "${requestedName}" not found in source. Available skills (${discovered.length}): ${available}`);
+    }
+    if (discovered.length === 1) {
+        return {
+            sourceSkillPath: discovered[0].sourceSkillPath,
+            skillName: discovered[0].skillName,
+            meta: discovered[0].meta
+        };
     }
-    throw new Error(`Could not find a valid skill with SKILL.md in source: ${sourceDir}`);
+    // Check if one matches the sourceDir basename
+    const baseName = path.basename(sourceDir);
+    const baseMatch = discovered.find((s) => s.skillName === baseName || path.basename(s.sourceSkillPath) === baseName);
+    if (baseMatch) {
+        return {
+            sourceSkillPath: baseMatch.sourceSkillPath,
+            skillName: baseMatch.skillName,
+            meta: baseMatch.meta
+        };
+    }
+    const available = discovered.map((s) => s.skillName).join(", ");
+    throw new Error(`Multiple skills found in source (${discovered.length} skills: ${available}). Please specify --name <skill-name> or use --all to install all skills.`);
 }
 export async function installThirdPartySkill(projectRoot, source, options) {
     const isGitUrl = /^https?:\/\/|^git@|^ssh:\/\/|\.git$/.test(source);
@@ -251,6 +255,64 @@ export async function installThirdPartySkill(projectRoot, source, options) {
                 throw new Error(`Source directory does not exist: ${source}`);
             }
         }
+        const recordedSource = options?.overrideSource || source;
+        const recordedType = isGitUrl || options?.overrideSource ? "git" : "local";
+        if (options?.all) {
+            const discovered = await discoverSkillsInDirectory(sourceDirectory);
+            if (discovered.length === 0) {
+                throw new Error(`Could not find any valid skill with SKILL.md in source: ${source}`);
+            }
+            const installedList = [];
+            const manifest = (await readDevflowManifest(projectRoot)) || {
+                schemaVersion: 1,
+                name: "nexus-devflow",
+                package: "@jakkrichm/create-nexus-devflow",
+                version: "2.9.3"
+            };
+            const existingThirdParty = Array.isArray(manifest.thirdPartySkills)
+                ? manifest.thirdPartySkills
+                : [];
+            let updatedThirdParty = [...existingThirdParty];
+            for (const skill of discovered) {
+                const skillName = skill.skillName;
+                if (!SKILL_NAME_PATTERN.test(skillName)) {
+                    continue; // skip invalid names in batch mode
+                }
+                if (coreNameSet.has(skillName) && !options?.force) {
+                    continue; // skip core collisions in batch mode
+                }
+                const targetAgentsSkillDir = path.join(projectRoot, ".agents", "skills", skillName);
+                const targetClaudeSkillDir = path.join(projectRoot, ".claude", "skills", skillName);
+                await fs.rm(targetAgentsSkillDir, { recursive: true, force: true });
+                await fs.rm(targetClaudeSkillDir, { recursive: true, force: true });
+                await fs.mkdir(path.dirname(targetAgentsSkillDir), { recursive: true });
+                await fs.mkdir(path.dirname(targetClaudeSkillDir), { recursive: true });
+                await fs.cp(skill.sourceSkillPath, targetAgentsSkillDir, { recursive: true });
+                await fs.cp(skill.sourceSkillPath, targetClaudeSkillDir, { recursive: true });
+                updatedThirdParty = updatedThirdParty.filter((s) => s.name !== skillName);
+                updatedThirdParty.push({
+                    name: skillName,
+                    source: recordedSource,
+                    version: skill.meta.version || "1.0.0",
+                    description: skill.meta.description || "",
+                    installedAt: new Date().toISOString(),
+                    type: recordedType
+                });
+                installedList.push({
+                    name: skillName,
+                    category: "third-party",
+                    description: skill.meta.description || "",
+                    version: skill.meta.version || "1.0.0",
+                    source: recordedSource,
+                    adapters: [".agents", ".claude"],
+                    synced: true,
+                    path: `.agents/skills/${skillName}`
+                });
+            }
+            manifest.thirdPartySkills = updatedThirdParty;
+            await writeDevflowManifest(projectRoot, manifest);
+            return installedList;
+        }
         const { sourceSkillPath, skillName, meta } = await findSkillSourceDirectory(sourceDirectory, options?.name);
         if (!SKILL_NAME_PATTERN.test(skillName)) {
             throw new Error(`Invalid skill name: "${skillName}". Must use kebab-case (e.g. "diagram-design").`);
@@ -273,7 +335,7 @@ export async function installThirdPartySkill(projectRoot, source, options) {
             schemaVersion: 1,
             name: "nexus-devflow",
             package: "@jakkrichm/create-nexus-devflow",
-            version: "2.9.0"
+            version: "2.9.3"
         };
         const existingThirdParty = Array.isArray(manifest.thirdPartySkills)
             ? manifest.thirdPartySkills
@@ -281,11 +343,11 @@ export async function installThirdPartySkill(projectRoot, source, options) {
         const filtered = existingThirdParty.filter((s) => s.name !== skillName);
         filtered.push({
             name: skillName,
-            source,
+            source: recordedSource,
             version: meta.version || "1.0.0",
             description: meta.description || "",
             installedAt: new Date().toISOString(),
-            type: isGitUrl ? "git" : "local"
+            type: recordedType
         });
         manifest.thirdPartySkills = filtered;
         await writeDevflowManifest(projectRoot, manifest);
@@ -294,7 +356,7 @@ export async function installThirdPartySkill(projectRoot, source, options) {
             category: "third-party",
             description: meta.description || "",
             version: meta.version || "1.0.0",
-            source,
+            source: recordedSource,
             adapters: [".agents", ".claude"],
             synced: true,
             path: `.agents/skills/${skillName}`
@@ -369,4 +431,80 @@ export async function syncSkills(projectRoot) {
         skills: syncedSkills
     };
 }
+export async function updateThirdPartySkills(projectRoot, targetSkillName, options) {
+    const manifest = await readDevflowManifest(projectRoot);
+    const existingThirdParty = Array.isArray(manifest?.thirdPartySkills)
+        ? manifest.thirdPartySkills
+        : [];
+    if (existingThirdParty.length === 0) {
+        return { updatedSkills: [], failedSkills: [], totalUpdated: 0 };
+    }
+    let skillsToUpdate = existingThirdParty;
+    if (targetSkillName && targetSkillName !== "--all") {
+        skillsToUpdate = existingThirdParty.filter((s) => s.name === targetSkillName);
+        if (skillsToUpdate.length === 0) {
+            throw new Error(`Skill "${targetSkillName}" is not installed as a third-party skill.`);
+        }
+    }
+    // Group by source to avoid duplicate cloning
+    const sourceToSkillsMap = new Map();
+    for (const skill of skillsToUpdate) {
+        const list = sourceToSkillsMap.get(skill.source) || [];
+        list.push(skill);
+        sourceToSkillsMap.set(skill.source, list);
+    }
+    const updatedSkills = [];
+    const failedSkills = [];
+    for (const [source, skills] of sourceToSkillsMap) {
+        const isGit = /^https?:\/\/|^git@|^ssh:\/\/|\.git$/.test(source);
+        let tempCloneDir = null;
+        try {
+            let sourceDir = source;
+            if (isGit) {
+                tempCloneDir = await fs.mkdtemp(path.join(os.tmpdir(), "nexus-skill-update-"));
+                await execFileAsync("git", ["clone", "--depth", "1", source, tempCloneDir]);
+                sourceDir = tempCloneDir;
+            }
+            for (const skill of skills) {
+                try {
+                    const detail = (await installThirdPartySkill(projectRoot, sourceDir, {
+                        name: skill.name,
+                        force: true,
+                        overrideSource: isGit ? source : undefined
+                    }));
+                    updatedSkills.push(detail);
+                }
+                catch (err) {
+                    failedSkills.push({
+                        name: skill.name,
+                        reason: err instanceof Error ? err.message : String(err)
+                    });
+                }
+            }
+        }
+        catch (err) {
+            for (const skill of skills) {
+                failedSkills.push({
+                    name: skill.name,
+                    reason: err instanceof Error ? err.message : String(err)
+                });
+            }
+        }
+        finally {
+            if (tempCloneDir) {
+                try {
+                    await fs.rm(tempCloneDir, { recursive: true, force: true });
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }
+    }
+    return {
+        updatedSkills,
+        failedSkills,
+        totalUpdated: updatedSkills.length
+    };
+}
 //# sourceMappingURL=skill-manager.js.map