botmux 3.11.0 → 3.12.1

package/dist/services/skill-pack-store.js

@@ -0,0 +1,270 @@
+import { existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { atomicWriteFileSync } from '../utils/atomic-write.js';
+import { withFileLockSync } from '../utils/file-lock.js';
+import { skillPackRegistryPath } from '../core/skills/registry-paths.js';
+const MAX_NAME_LENGTH = 80;
+const MAX_DESCRIPTION_LENGTH = 500;
+const MAX_TAGS = 20;
+const MAX_TAG_LENGTH = 40;
+const MAX_INCLUDE = 100;
+const LOCK_WAIT_MS = 30_000;
+export class SkillPackStoreError extends Error {
+    detail;
+    constructor(detail) {
+        super(detail.code);
+        this.detail = detail;
+        this.name = 'SkillPackStoreError';
+    }
+}
+function emptyRegistry() {
+    return { schemaVersion: 1, packs: {} };
+}
+function normalizeStoredTimestamp(value) {
+    if (typeof value !== 'string' || !value.trim() || Number.isNaN(Date.parse(value))) {
+        throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: 'timestamps must be date strings' });
+    }
+    return value;
+}
+function normalizeStoredPack(key, raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return undefined;
+    const value = raw;
+    try {
+        const id = validateId(value.id);
+        if (id !== key || validateId(key) !== key)
+            return undefined;
+        const revision = value.revision;
+        if (!Number.isSafeInteger(revision) || revision < 1) {
+            throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: 'revision must be a positive integer' });
+        }
+        return {
+            id,
+            name: validateName(value.name),
+            description: validateDescription(value.description),
+            tags: normalizeTags(value.tags),
+            include: normalizeInclude(value.include),
+            revision: revision,
+            createdAt: normalizeStoredTimestamp(value.createdAt),
+            updatedAt: normalizeStoredTimestamp(value.updatedAt),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+export function readSkillPackRegistry() {
+    return readSkillPackRegistryInternal(false);
+}
+/** Read-time callers stay tolerant so a damaged optional registry cannot take
+ * down session startup. Mutations must fail closed, however: treating an
+ * existing malformed file as empty and then writing it back would erase every
+ * recoverable pack on the next create/update/delete. */
+function readSkillPackRegistryInternal(strict) {
+    const file = skillPackRegistryPath();
+    if (!existsSync(file))
+        return emptyRegistry();
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(file, 'utf-8'));
+    }
+    catch {
+        // Malformed JSON or an unreadable file must not take down the whole skill
+        // pipeline; bots keep working and invalid packs resolve to nothing.
+        if (strict) {
+            throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: 'existing packs registry is unreadable or malformed' });
+        }
+        return emptyRegistry();
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        if (strict)
+            throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: 'existing packs registry must be an object' });
+        return emptyRegistry();
+    }
+    const registry = parsed;
+    if (registry.schemaVersion !== 1 || !registry.packs || typeof registry.packs !== 'object' || Array.isArray(registry.packs)) {
+        if (strict)
+            throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: 'existing packs registry schema is invalid' });
+        return emptyRegistry();
+    }
+    const packs = {};
+    for (const [key, raw] of Object.entries(registry.packs)) {
+        const pack = normalizeStoredPack(key, raw);
+        if (!pack) {
+            if (strict)
+                throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: `stored pack "${key}" is invalid` });
+            continue;
+        }
+        packs[key] = pack;
+    }
+    return { schemaVersion: 1, packs };
+}
+function writeSkillPackRegistry(registry) {
+    mkdirSync(dirname(skillPackRegistryPath()), { recursive: true });
+    atomicWriteFileSync(skillPackRegistryPath(), JSON.stringify(registry, null, 2) + '\n', { mode: 0o600 });
+}
+function withSkillPackMutation(mutate) {
+    const file = skillPackRegistryPath();
+    mkdirSync(dirname(file), { recursive: true });
+    return withFileLockSync(file, () => {
+        const registry = readSkillPackRegistryInternal(true);
+        const result = mutate(registry);
+        writeSkillPackRegistry(registry);
+        return result;
+    }, { maxWaitMs: LOCK_WAIT_MS });
+}
+function isSkillSelector(value) {
+    return typeof value === 'string' && /^skill:.+$/.test(value);
+}
+function normalizeInclude(raw) {
+    if (!Array.isArray(raw))
+        throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: 'include must be an array' });
+    const seen = new Set();
+    const out = [];
+    for (const item of raw) {
+        if (!isSkillSelector(item)) {
+            throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID_SELECTOR', selector: String(item) });
+        }
+        if (seen.has(item))
+            continue;
+        seen.add(item);
+        out.push(item);
+    }
+    if (out.length === 0)
+        throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: 'include must contain at least one skill' });
+    if (out.length > MAX_INCLUDE)
+        throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: `include exceeds ${MAX_INCLUDE} skills` });
+    return out;
+}
+function normalizeTags(raw) {
+    if (raw === undefined || raw === null)
+        return undefined;
+    if (!Array.isArray(raw))
+        throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: 'tags must be an array' });
+    const out = [];
+    for (const tag of raw) {
+        if (typeof tag !== 'string')
+            throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: 'tags must be strings' });
+        const trimmed = tag.trim();
+        if (!trimmed)
+            continue;
+        if (trimmed.length > MAX_TAG_LENGTH)
+            throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: `tag exceeds ${MAX_TAG_LENGTH} chars` });
+        if (!out.includes(trimmed))
+            out.push(trimmed);
+    }
+    if (out.length > MAX_TAGS)
+        throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: `tags exceed ${MAX_TAGS}` });
+    return out.length > 0 ? out : undefined;
+}
+function validateId(id) {
+    if (typeof id !== 'string' || !/^[a-z0-9][a-z0-9-]*$/.test(id)) {
+        throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: 'id must be a lowercase slug (a-z, 0-9, -)' });
+    }
+    return id;
+}
+function validateName(name) {
+    if (typeof name !== 'string' || !name.trim()) {
+        throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: 'name is required' });
+    }
+    const trimmed = name.trim();
+    if (trimmed.length > MAX_NAME_LENGTH) {
+        throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: `name exceeds ${MAX_NAME_LENGTH} chars` });
+    }
+    return trimmed;
+}
+function validateDescription(description) {
+    if (description === undefined || description === null)
+        return undefined;
+    if (typeof description !== 'string') {
+        throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: 'description must be a string' });
+    }
+    const trimmed = description.trim();
+    if (!trimmed)
+        return undefined;
+    if (trimmed.length > MAX_DESCRIPTION_LENGTH) {
+        throw new SkillPackStoreError({ code: 'SKILL_PACK_INVALID', reason: `description exceeds ${MAX_DESCRIPTION_LENGTH} chars` });
+    }
+    return trimmed;
+}
+export function listSkillPacks() {
+    return Object.values(readSkillPackRegistry().packs).sort((a, b) => a.name.localeCompare(b.name));
+}
+export function getSkillPack(id) {
+    const packs = readSkillPackRegistry().packs;
+    return Object.hasOwn(packs, id) ? packs[id] : undefined;
+}
+export function createSkillPack(input) {
+    const id = validateId(input.id);
+    return withSkillPackMutation((registry) => {
+        if (Object.hasOwn(registry.packs, id)) {
+            throw new SkillPackStoreError({ code: 'SKILL_PACK_ID_CONFLICT', id });
+        }
+        const now = new Date().toISOString();
+        const pack = {
+            id,
+            name: validateName(input.name),
+            description: validateDescription(input.description),
+            tags: normalizeTags(input.tags),
+            include: normalizeInclude(input.include),
+            revision: 1,
+            createdAt: now,
+            updatedAt: now,
+        };
+        registry.packs[id] = pack;
+        return pack;
+    });
+}
+export function updateSkillPack(id, input) {
+    return withSkillPackMutation((registry) => {
+        if (!Object.hasOwn(registry.packs, id))
+            throw new SkillPackStoreError({ code: 'SKILL_PACK_NOT_FOUND', id });
+        const existing = registry.packs[id];
+        if (input.expectedRevision !== undefined && input.expectedRevision !== existing.revision) {
+            throw new SkillPackStoreError({ code: 'SKILL_PACK_REVISION_CONFLICT', id, current: existing.revision });
+        }
+        const updated = {
+            ...existing,
+            name: input.name !== undefined ? validateName(input.name) : existing.name,
+            description: input.description !== undefined ? validateDescription(input.description) : existing.description,
+            tags: input.tags !== undefined ? normalizeTags(input.tags) : existing.tags,
+            include: input.include !== undefined ? normalizeInclude(input.include) : existing.include,
+            revision: existing.revision + 1,
+            updatedAt: new Date().toISOString(),
+        };
+        registry.packs[id] = updated;
+        return updated;
+    });
+}
+export function deleteSkillPack(id) {
+    withSkillPackMutation((registry) => {
+        if (!Object.hasOwn(registry.packs, id))
+            throw new SkillPackStoreError({ code: 'SKILL_PACK_NOT_FOUND', id });
+        delete registry.packs[id];
+    });
+}
+export function cloneSkillPack(id, newId) {
+    const targetId = validateId(newId);
+    return withSkillPackMutation((registry) => {
+        if (!Object.hasOwn(registry.packs, id))
+            throw new SkillPackStoreError({ code: 'SKILL_PACK_NOT_FOUND', id });
+        const source = registry.packs[id];
+        if (Object.hasOwn(registry.packs, targetId)) {
+            throw new SkillPackStoreError({ code: 'SKILL_PACK_ID_CONFLICT', id: targetId });
+        }
+        const now = new Date().toISOString();
+        const clone = {
+            id: targetId,
+            name: validateName(`${source.name} (copy)`),
+            description: source.description,
+            tags: source.tags ? [...source.tags] : undefined,
+            include: [...source.include],
+            revision: 1,
+            createdAt: now,
+            updatedAt: now,
+        };
+        registry.packs[targetId] = clone;
+        return clone;
+    });
+}
+//# sourceMappingURL=skill-pack-store.js.map

package/dist/services/skill-pack-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-pack-store.js","sourceRoot":"","sources":["../../src/services/skill-pack-store.ts"],"names":[],"mappings":"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"}

package/dist/services/skill-registry-store.d.ts

@@ -14,6 +14,9 @@ export interface SkillSourceDiscovery {
     /** True when the source resolves its own skill set (agentbuddy) — the dashboard
      *  installs it directly, skipping the discover-then-select step. */
     directInstall?: boolean;
+    /** True when discovery fell back to a full-depth recursive scan. The UI
+     *  surfaces this so the deeper (slower) scan is visible rather than silent. */
+    deepScanned?: boolean;
 }
 export interface SkillInstallSelection {
     skillNames?: string[];
@@ -47,6 +50,7 @@ export declare function installLocalSkill(dir: string, opts: {
 export declare function installLocalSkillLinks(dirs: readonly string[]): SkillPackage[];
 export declare function discoverLocalSkillCandidates(rootDir: string, opts?: {
     fullDepth?: boolean;
+    fallbackToFullDepth?: boolean;
 }): SkillSourceDiscovery;
 export declare function installLocalSkillsFromSource(rootDir: string, opts: {
     link: boolean;
@@ -56,12 +60,16 @@ export declare function discoverGitSkillCandidates(opts: {
     ref?: string;
     path?: string;
     fullDepth?: boolean;
+    fallbackToFullDepth?: boolean;
 }): SkillSourceDiscovery;
 export declare function discoverGitSkillCandidatesAsync(opts: {
     url: string;
     ref?: string;
     path?: string;
     fullDepth?: boolean;
+    /** Retry recursively against the same checkout so mixed repository layouts
+     *  produce the same candidate set during discovery and installation. */
+    fallbackToFullDepth?: boolean;
 }): Promise<SkillSourceDiscovery>;
 export declare function installGitSkill(opts: {
     url: string;

package/dist/services/skill-registry-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-registry-store.d.ts","sourceRoot":"","sources":["../../src/services/skill-registry-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skill-registry-store.d.ts","sourceRoot":"","sources":["../../src/services/skill-registry-store.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAMlE,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnC;wEACoE;IACpE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;mFAC+E;IAC/E,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,CAAC,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACtC;AAMD,wBAAgB,iBAAiB,IAAI,iBAAiB,CAkBrD;AAyBD;8EAC8E;AAC9E,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,YAAY,GAAG,wBAAwB,CAgDzF;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,YAAY,CAqBpF;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,EAAE,CA8B9E;AAiHD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAO,GAChE,oBAAoB,CAsCtB;AAuBD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,qBAAqB,GAC9C,YAAY,EAAE,CAUhB;AA4YD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,GAAG,oBAAoB,CAOvB;AAED,wBAAsB,+BAA+B,CAAC,IAAI,EAAE;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;4EACwE;IACxE,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAOhC;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,WAAW,CAAC;CAC9B,GAAG,YAAY,CAEf;AA+CD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,WAAW,CAAC;CAC9B,GAAG,OAAO,CAAC,YAAY,CAAC,CAExB;AAqBD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,WAAW,CAAC;CAC9B,GAAG,qBAAqB,GAAG,YAAY,EAAE,CAezC;AAED,wBAAsB,+BAA+B,CAAC,IAAI,EAAE;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,WAAW,CAAC;CAC9B,GAAG,qBAAqB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAelD;AAwRD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAexG;AAED;;sEAEsE;AACtE,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAe5H;AASD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAG/F;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAC1D;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GAC/B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAepD;AAYD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA+BpH;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA+BxI"}

package/dist/services/skill-registry-store.js

@@ -8,23 +8,32 @@ import { withFileLock, withFileLockSync } from '../utils/file-lock.js';
 import { githubGitAuthEnv } from '../core/github-auth.js';
 import { loadSkillPackage } from '../core/skills/package.js';
 import { skillRegistryPath, skillSourcesDir, skillStoreDir } from '../core/skills/registry-paths.js';
-import { assertAllowedGitProtocol, assertNoGitUrlCredentials, assertSafeGitRef, assertSafeGitSkillPath, githubToGitUrl, redactGitUrlCredentials } from '../core/skills/sources.js';
+import { assertAllowedGitProtocol, assertNoGitUrlCredentials, assertSafeGitRef, assertSafeGitSkillPath, formatAgentbuddyIdentifier, githubToGitUrl, redactGitUrlCredentials } from '../core/skills/sources.js';
 const DEFAULT_GIT_TIMEOUT_MS = 60_000;
 const execFileAsync = promisify(execFile);
 const gitSourceLocks = new Map();
+function emptySkillRegistryMap() {
+    return Object.create(null);
+}
 export function readSkillRegistry() {
     const file = skillRegistryPath();
     if (!existsSync(file))
-        return { schemaVersion: 1, skills: {} };
+        return { schemaVersion: 1, skills: emptySkillRegistryMap() };
     try {
         const parsed = JSON.parse(readFileSync(file, 'utf-8'));
+        const skills = emptySkillRegistryMap();
+        if (parsed?.skills && typeof parsed.skills === 'object' && !Array.isArray(parsed.skills)) {
+            for (const [name, skill] of Object.entries(parsed.skills)) {
+                skills[name] = skill;
+            }
+        }
         return {
             schemaVersion: 1,
-            skills: parsed?.skills && typeof parsed.skills === 'object' ? parsed.skills : {},
+            skills,
         };
     }
     catch {
-        return { schemaVersion: 1, skills: {} };
+        return { schemaVersion: 1, skills: emptySkillRegistryMap() };
     }
 }
 function writeSkillRegistry(registry) {
@@ -230,17 +239,34 @@ function dedupeAndSortCandidates(candidates) {
         byPath.set(candidate.path, candidate);
     return [...byPath.values()].sort((a, b) => a.path.localeCompare(b.path));
 }
-function walkSkillDirs(parentDir, dir, out, depth) {
+const INCIDENTAL_DISCOVERY_DIRS = new Set([
+    'assets',
+    'example',
+    'examples',
+    'fixtures',
+    'images',
+    'test',
+    'tests',
+]);
+function walkSkillDirs(parentDir, dir, out, depth, opts = {}) {
     if (depth > 4)
         return;
     for (const child of listChildDirs(dir)) {
-        const name = child.split('/').pop() ?? '';
+        const name = basename(child);
         if (name === '.git' || name === 'node_modules')
             continue;
         const candidate = candidateFromDir(parentDir, child);
-        if (candidate)
+        if (candidate) {
             out.push(candidate);
-        walkSkillDirs(parentDir, child, out, depth + 1);
+            // A discovered skill is a package boundary. During automatic fallback,
+            // do not mistake bundled examples or fixtures for sibling skills.
+            if (opts.skipIncidental)
+                continue;
+        }
+        else if (opts.skipIncidental && INCIDENTAL_DISCOVERY_DIRS.has(name.toLowerCase())) {
+            continue;
+        }
+        walkSkillDirs(parentDir, child, out, depth + 1, opts);
     }
 }
 export function discoverLocalSkillCandidates(rootDir, opts = {}) {
@@ -250,31 +276,39 @@ export function discoverLocalSkillCandidates(rootDir, opts = {}) {
     const rootCandidate = candidateFromDir(sourceDir, sourceDir);
     if (rootCandidate) {
         candidates.push(rootCandidate);
-        if (!opts.fullDepth)
+        if (!opts.fullDepth && !opts.fallbackToFullDepth) {
             return { skills: dedupeAndSortCandidates(candidates) };
+        }
     }
     // Native CLI libraries are themselves named `skills` (for example
     // ~/.claude/skills). When callers pass that library root directly, scan its
     // immediate children instead of looking for a redundant skills/skills layer.
     // Check both the requested and canonical paths so a symlink named `skills`
     // still gets the expected behavior after realpath resolution.
-    if (basename(requestedDir) === 'skills' || basename(sourceDir) === 'skills') {
-        for (const child of listChildDirs(sourceDir)) {
+    const scanShallowRoot = (libraryRoot) => {
+        for (const child of listChildDirs(libraryRoot)) {
             const candidate = candidateFromDir(sourceDir, child);
             if (candidate)
                 candidates.push(candidate);
         }
+    };
+    if (basename(requestedDir) === 'skills' || basename(sourceDir) === 'skills') {
+        scanShallowRoot(sourceDir);
     }
     for (const relativeRoot of ['skills', '.agents/skills', '.botmux/skills']) {
-        for (const child of listChildDirs(join(sourceDir, relativeRoot))) {
-            const candidate = candidateFromDir(sourceDir, child);
-            if (candidate)
-                candidates.push(candidate);
-        }
+        scanShallowRoot(join(sourceDir, relativeRoot));
     }
-    if (opts.fullDepth)
+    const useFallback = !opts.fullDepth && opts.fallbackToFullDepth === true;
+    if (opts.fullDepth) {
         walkSkillDirs(sourceDir, sourceDir, candidates, 0);
-    return { skills: dedupeAndSortCandidates(candidates) };
+    }
+    else if (useFallback) {
+        walkSkillDirs(sourceDir, sourceDir, candidates, 0, { skipIncidental: true });
+    }
+    return {
+        skills: dedupeAndSortCandidates(candidates),
+        ...(useFallback ? { deepScanned: true } : {}),
+    };
 }
 function selectDiscoveredSkills(candidates, selection = {}) {
     if (candidates.length === 0)
@@ -300,7 +334,10 @@ function selectDiscoveredSkills(candidates, selection = {}) {
 }
 export function installLocalSkillsFromSource(rootDir, opts) {
     const sourceDir = resolve(rootDir);
-    const discovery = discoverLocalSkillCandidates(sourceDir, { fullDepth: opts.fullDepth });
+    const discovery = discoverLocalSkillCandidates(sourceDir, {
+        fullDepth: opts.fullDepth,
+        fallbackToFullDepth: !opts.fullDepth,
+    });
     return selectDiscoveredSkills(discovery.skills, opts).map(candidate => {
         const skillDir = candidate.path === '.' ? sourceDir : join(sourceDir, candidate.path);
         return installLocalSkill(skillDir, { link: opts.link });
@@ -614,7 +651,10 @@ function discoverCheckedOutGitSource(sourceDir, commit, opts) {
     }
     return {
         commit,
-        skills: discoverLocalSkillCandidates(sourceDir, { fullDepth: opts.fullDepth }).skills,
+        ...discoverLocalSkillCandidates(sourceDir, {
+            fullDepth: opts.fullDepth,
+            fallbackToFullDepth: opts.fallbackToFullDepth,
+        }),
     };
 }
 function checkoutTemporaryGitSource(url, refValue) {
@@ -695,47 +735,43 @@ export function installGitSkill(opts) {
     return withGitSourceLockSync(opts.url, () => installGitSkillLocked(opts));
 }
 function installGitSkillLocked(opts) {
-    const { sourceDir, ref, commit } = checkoutGitSource(opts.url, opts.ref);
+    const checkout = checkoutGitSource(opts.url, opts.ref);
+    return persistInstalledGitSkills([
+        copyGitSkillFromCheckout({ ...opts, ...checkout }),
+    ])[0];
+}
+function copyGitSkillFromCheckout(opts) {
     const source = opts.sourceOverride
         ? opts.sourceOverride.type === 'git' || opts.sourceOverride.type === 'github'
-            ? { ...opts.sourceOverride, commit }
+            ? { ...opts.sourceOverride, commit: opts.commit }
             : opts.sourceOverride
-        : { type: 'git', url: opts.url, path: opts.path, ref, commit };
-    const skillDir = gitSkillDir(sourceDir, opts.path);
+        : { type: 'git', url: opts.url, path: opts.path, ref: opts.ref, commit: opts.commit };
+    const skillDir = gitSkillDir(opts.sourceDir, opts.path);
     const provisional = loadSkillPackage(skillDir, { source });
     const rootDir = join(skillStoreDir(), provisional.name);
     rmSync(rootDir, { recursive: true, force: true });
     mkdirSync(dirname(rootDir), { recursive: true });
     cpSync(skillDir, rootDir, { recursive: true });
-    const pkg = loadSkillPackage(rootDir, { source, id: provisional.id });
+    return loadSkillPackage(rootDir, { source, id: provisional.id });
+}
+function persistInstalledGitSkills(packages) {
     const now = new Date().toISOString();
     const registry = readSkillRegistry();
-    registry.skills[pkg.name] = { ...pkg, installedAt: now, updatedAt: now };
+    const installed = packages.map((pkg) => {
+        registry.skills[pkg.name] = { ...pkg, installedAt: now, updatedAt: now };
+        return registry.skills[pkg.name];
+    });
     writeSkillRegistry(registry);
-    return registry.skills[pkg.name];
+    return installed;
 }
 export async function installGitSkillAsync(opts) {
     return withGitSourceLock(opts.url, () => installGitSkillAsyncLocked(opts));
 }
 async function installGitSkillAsyncLocked(opts) {
-    const { sourceDir, ref, commit } = await checkoutGitSourceAsync(opts.url, opts.ref);
-    const source = opts.sourceOverride
-        ? opts.sourceOverride.type === 'git' || opts.sourceOverride.type === 'github'
-            ? { ...opts.sourceOverride, commit }
-            : opts.sourceOverride
-        : { type: 'git', url: opts.url, path: opts.path, ref, commit };
-    const skillDir = gitSkillDir(sourceDir, opts.path);
-    const provisional = loadSkillPackage(skillDir, { source });
-    const rootDir = join(skillStoreDir(), provisional.name);
-    rmSync(rootDir, { recursive: true, force: true });
-    mkdirSync(dirname(rootDir), { recursive: true });
-    cpSync(skillDir, rootDir, { recursive: true });
-    const pkg = loadSkillPackage(rootDir, { source, id: provisional.id });
-    const now = new Date().toISOString();
-    const registry = readSkillRegistry();
-    registry.skills[pkg.name] = { ...pkg, installedAt: now, updatedAt: now };
-    writeSkillRegistry(registry);
-    return registry.skills[pkg.name];
+    const checkout = await checkoutGitSourceAsync(opts.url, opts.ref);
+    return persistInstalledGitSkills([
+        copyGitSkillFromCheckout({ ...opts, ...checkout }),
+    ])[0];
 }
 function sourceOverrideForCandidate(source, candidate) {
     if (!source)
@@ -749,31 +785,33 @@ function sourceOverrideForCandidate(source, candidate) {
 export function installGitSkillsFromSource(opts) {
     return withGitSourceLockSync(opts.url, () => {
         const checkout = checkoutGitSource(opts.url, opts.ref);
-        const discovery = discoverCheckedOutGitSource(checkout.sourceDir, checkout.commit, { fullDepth: opts.fullDepth });
+        const discovery = discoverCheckedOutGitSource(checkout.sourceDir, checkout.commit, {
+            fullDepth: opts.fullDepth,
+            fallbackToFullDepth: !opts.fullDepth,
+        });
         const selected = selectDiscoveredSkills(discovery.skills, opts);
-        return selected.map(candidate => installGitSkillLocked({
+        return persistInstalledGitSkills(selected.map(candidate => copyGitSkillFromCheckout({
+            ...checkout,
             url: opts.url,
             path: candidate.path,
-            ref: opts.ref,
             sourceOverride: sourceOverrideForCandidate(opts.sourceOverride, candidate),
-        }));
+        })));
     });
 }
 export async function installGitSkillsFromSourceAsync(opts) {
     return withGitSourceLock(opts.url, async () => {
         const checkout = await checkoutGitSourceAsync(opts.url, opts.ref);
-        const discovery = discoverCheckedOutGitSource(checkout.sourceDir, checkout.commit, { fullDepth: opts.fullDepth });
+        const discovery = discoverCheckedOutGitSource(checkout.sourceDir, checkout.commit, {
+            fullDepth: opts.fullDepth,
+            fallbackToFullDepth: !opts.fullDepth,
+        });
         const selected = selectDiscoveredSkills(discovery.skills, opts);
-        const installed = [];
-        for (const candidate of selected) {
-            installed.push(await installGitSkillAsyncLocked({
-                url: opts.url,
-                path: candidate.path,
-                ref: opts.ref,
-                sourceOverride: sourceOverrideForCandidate(opts.sourceOverride, candidate),
-            }));
-        }
-        return installed;
+        return persistInstalledGitSkills(selected.map(candidate => copyGitSkillFromCheckout({
+            ...checkout,
+            url: opts.url,
+            path: candidate.path,
+            sourceOverride: sourceOverrideForCandidate(opts.sourceOverride, candidate),
+        })));
     });
 }
 // --- agentbuddy (external CLI) skill source ---------------------------------
@@ -961,12 +999,6 @@ function findSkillDirs(root) {
     walk(root);
     return found;
 }
-function agentbuddyIdentifier(opts) {
-    const protocol = opts.protocol ?? 'skill';
-    return opts.collection
-        ? `${protocol}/collection/${opts.collection}`
-        : `${protocol}/${opts.group}/${opts.skill}${opts.version ? `@${opts.version}` : ''}`;
-}
 /** Register the skill dir(s) agentbuddy wrote into the staging tree into the
  *  botmux store. Shared by the sync (CLI) and async (dashboard job) install
  *  paths so they stay behaviourally identical.
@@ -1086,7 +1118,7 @@ async function runAgentbuddyCliAsync(args, cwd, failCode) {
     });
 }
 export function installAgentbuddySkill(opts, requireSkillName) {
-    const identifier = agentbuddyIdentifier(opts);
+    const identifier = formatAgentbuddyIdentifier(opts);
     return withAgentbuddyLockSync(identifier, () => {
         const staging = join(skillSourcesDir(), 'agentbuddy', sourceId(identifier));
         rmSync(staging, { recursive: true, force: true });
@@ -1107,7 +1139,7 @@ export function installAgentbuddySkill(opts, requireSkillName) {
  *  behaviour, but awaits the (minutes-long, network-bound) agentbuddy calls off
  *  the daemon event loop instead of blocking it with execFileSync. */
 export async function installAgentbuddySkillAsync(opts, requireSkillName) {
-    const identifier = agentbuddyIdentifier(opts);
+    const identifier = formatAgentbuddyIdentifier(opts);
     return withAgentbuddyLock(identifier, async () => {
         const staging = join(skillSourcesDir(), 'agentbuddy', sourceId(identifier));
         rmSync(staging, { recursive: true, force: true });