pilothub 0.0.1 → 0.0.2

package/dist/cli/pilotbotConfig.js

@@ -0,0 +1,110 @@
+import { readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { basename, join, resolve } from 'node:path';
+import JSON5 from 'json5';
+export async function resolvePilotbotSkillRoots() {
+    const roots = [];
+    const labels = {};
+    const stateDir = resolvePilotbotStateDir();
+    const sharedSkills = resolveUserPath(join(stateDir, 'skills'));
+    pushRoot(roots, labels, sharedSkills, 'Shared skills');
+    const config = await readPilotbotConfig();
+    if (!config)
+        return { roots, labels };
+    const mainWorkspace = resolveUserPath(config.agents?.defaults?.workspace ?? config.agent?.workspace ?? '');
+    if (mainWorkspace) {
+        pushRoot(roots, labels, join(mainWorkspace, 'skills'), 'Agent: main');
+    }
+    const listedAgents = config.agents?.list ?? [];
+    for (const entry of listedAgents) {
+        const workspace = resolveUserPath(entry?.workspace ?? '');
+        if (!workspace)
+            continue;
+        const name = entry?.name?.trim() || entry?.id?.trim() || 'agent';
+        pushRoot(roots, labels, join(workspace, 'skills'), `Agent: ${name}`);
+    }
+    const agents = config.routing?.agents ?? {};
+    for (const [agentId, entry] of Object.entries(agents)) {
+        const workspace = resolveUserPath(entry?.workspace ?? '');
+        if (!workspace)
+            continue;
+        const name = entry?.name?.trim() || agentId;
+        pushRoot(roots, labels, join(workspace, 'skills'), `Agent: ${name}`);
+    }
+    const extraDirs = config.skills?.load?.extraDirs ?? [];
+    for (const dir of extraDirs) {
+        const resolved = resolveUserPath(String(dir));
+        if (!resolved)
+            continue;
+        const label = `Extra: ${basename(resolved) || resolved}`;
+        pushRoot(roots, labels, resolved, label);
+    }
+    return { roots, labels };
+}
+export async function resolvePilotbotDefaultWorkspace() {
+    const config = await readPilotbotConfig();
+    if (!config)
+        return null;
+    const defaultsWorkspace = resolveUserPath(config.agents?.defaults?.workspace ?? config.agent?.workspace ?? '');
+    if (defaultsWorkspace)
+        return defaultsWorkspace;
+    const listedAgents = config.agents?.list ?? [];
+    const defaultAgent = listedAgents.find((entry) => entry.default) ?? listedAgents.find((entry) => entry.id === 'main');
+    const listWorkspace = resolveUserPath(defaultAgent?.workspace ?? '');
+    return listWorkspace || null;
+}
+function resolvePilotbotStateDir() {
+    const override = process.env.PILOTBOT_STATE_DIR?.trim();
+    if (override)
+        return resolveUserPath(override);
+    return join(homedir(), '.pilotbot');
+}
+function resolvePilotbotConfigPath() {
+    const override = process.env.PILOTBOT_CONFIG_PATH?.trim();
+    if (override)
+        return resolveUserPath(override);
+    return join(resolvePilotbotStateDir(), 'pilotbot.json');
+}
+function resolveUserPath(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        return '';
+    if (trimmed.startsWith('~')) {
+        return resolve(trimmed.replace(/^~(?=$|[\\/])/, homedir()));
+    }
+    return resolve(trimmed);
+}
+async function readPilotbotConfig() {
+    try {
+        const raw = await readFile(resolvePilotbotConfigPath(), 'utf8');
+        const parsed = JSON5.parse(raw);
+        if (!parsed || typeof parsed !== 'object')
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function pushRoot(roots, labels, root, label) {
+    const resolved = resolveUserPath(root);
+    if (!resolved)
+        return;
+    if (!roots.includes(resolved))
+        roots.push(resolved);
+    if (!label)
+        return;
+    const existing = labels[resolved];
+    if (!existing) {
+        labels[resolved] = label;
+        return;
+    }
+    const parts = existing
+        .split(', ')
+        .map((part) => part.trim())
+        .filter(Boolean);
+    if (parts.includes(label))
+        return;
+    labels[resolved] = `${existing}, ${label}`;
+}
+//# sourceMappingURL=pilotbotConfig.js.map

package/dist/cli/pilotbotConfig.js.map

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

package/dist/cli/pilotbotConfig.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/pilotbotConfig.test.js

@@ -0,0 +1,133 @@
+/* @vitest-environment node */
+import { mkdir, mkdtemp, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { resolvePilotbotDefaultWorkspace, resolvePilotbotSkillRoots } from './pilotbotConfig.js';
+const originalEnv = { ...process.env };
+afterEach(() => {
+    process.env = { ...originalEnv };
+});
+describe('resolvePilotbotSkillRoots', () => {
+    it('reads JSON5 config and resolves per-agent + shared skill roots', async () => {
+        const base = await mkdtemp(join(tmpdir(), 'pilothub-pilotbot-'));
+        const home = join(base, 'home');
+        const stateDir = join(base, 'state');
+        const configPath = join(base, 'pilotbot.json');
+        process.env.HOME = home;
+        process.env.PILOTBOT_STATE_DIR = stateDir;
+        process.env.PILOTBOT_CONFIG_PATH = configPath;
+        const config = `{
+      // JSON5 comments + trailing commas supported
+      agents: {
+        defaults: { workspace: '~/pilot-main', },
+        list: [
+          { id: 'work', name: 'Work Bot', workspace: '~/pilot-work', },
+          { id: 'family', workspace: '~/pilot-family', },
+        ],
+      },
+      // legacy entries still supported
+      agent: { workspace: '~/pilot-legacy', },
+      routing: {
+        agents: {
+          work: { name: 'Work Bot', workspace: '~/pilot-work', },
+          family: { workspace: '~/pilot-family' },
+        },
+      },
+      skills: {
+        load: { extraDirs: ['~/shared/skills', '/opt/skills',], },
+      },
+    }`;
+        await writeFile(configPath, config, 'utf8');
+        const { roots, labels } = await resolvePilotbotSkillRoots();
+        const expectedRoots = [
+            resolve(stateDir, 'skills'),
+            resolve(home, 'pilot-main', 'skills'),
+            resolve(home, 'pilot-work', 'skills'),
+            resolve(home, 'pilot-family', 'skills'),
+            resolve(home, 'shared', 'skills'),
+            resolve('/opt/skills'),
+        ];
+        expect(roots).toEqual(expect.arrayContaining(expectedRoots));
+        expect(labels[resolve(stateDir, 'skills')]).toBe('Shared skills');
+        expect(labels[resolve(home, 'pilot-main', 'skills')]).toBe('Agent: main');
+        expect(labels[resolve(home, 'pilot-work', 'skills')]).toBe('Agent: Work Bot');
+        expect(labels[resolve(home, 'pilot-family', 'skills')]).toBe('Agent: family');
+        expect(labels[resolve(home, 'shared', 'skills')]).toBe('Extra: skills');
+        expect(labels[resolve('/opt/skills')]).toBe('Extra: skills');
+    });
+    it('resolves default workspace from agents.defaults and agents.list', async () => {
+        const base = await mkdtemp(join(tmpdir(), 'pilothub-pilotbot-default-'));
+        const home = join(base, 'home');
+        const stateDir = join(base, 'state');
+        const configPath = join(base, 'pilotbot.json');
+        const workspaceMain = join(base, 'workspace-main');
+        const workspaceList = join(base, 'workspace-list');
+        process.env.HOME = home;
+        process.env.PILOTBOT_STATE_DIR = stateDir;
+        process.env.PILOTBOT_CONFIG_PATH = configPath;
+        const config = `{
+      agents: {
+        defaults: { workspace: "${workspaceMain}", },
+        list: [
+          { id: 'main', workspace: "${workspaceList}", default: true },
+        ],
+      },
+    }`;
+        await writeFile(configPath, config, 'utf8');
+        const workspace = await resolvePilotbotDefaultWorkspace();
+        expect(workspace).toBe(resolve(workspaceMain));
+    });
+    it('falls back to default agent in agents.list when defaults missing', async () => {
+        const base = await mkdtemp(join(tmpdir(), 'pilothub-pilotbot-list-'));
+        const home = join(base, 'home');
+        const configPath = join(base, 'pilotbot.json');
+        const workspaceMain = join(base, 'workspace-main');
+        const workspaceWork = join(base, 'workspace-work');
+        process.env.HOME = home;
+        process.env.PILOTBOT_CONFIG_PATH = configPath;
+        const config = `{
+      agents: {
+        list: [
+          { id: 'main', workspace: "${workspaceMain}", default: true },
+          { id: 'work', workspace: "${workspaceWork}" },
+        ],
+      },
+    }`;
+        await writeFile(configPath, config, 'utf8');
+        const workspace = await resolvePilotbotDefaultWorkspace();
+        expect(workspace).toBe(resolve(workspaceMain));
+    });
+    it('respects PILOTBOT_STATE_DIR and PILOTBOT_CONFIG_PATH overrides', async () => {
+        const base = await mkdtemp(join(tmpdir(), 'pilothub-pilotbot-override-'));
+        const home = join(base, 'home');
+        const stateDir = join(base, 'custom-state');
+        const configPath = join(base, 'config', 'pilotbot.json');
+        process.env.HOME = home;
+        process.env.PILOTBOT_STATE_DIR = stateDir;
+        process.env.PILOTBOT_CONFIG_PATH = configPath;
+        const config = `{
+      agent: { workspace: "${join(base, 'workspace-main')}" },
+    }`;
+        await mkdir(join(base, 'config'), { recursive: true });
+        await writeFile(configPath, config, 'utf8');
+        const { roots, labels } = await resolvePilotbotSkillRoots();
+        expect(roots).toEqual(expect.arrayContaining([
+            resolve(stateDir, 'skills'),
+            resolve(join(base, 'workspace-main'), 'skills'),
+        ]));
+        expect(labels[resolve(stateDir, 'skills')]).toBe('Shared skills');
+        expect(labels[resolve(join(base, 'workspace-main'), 'skills')]).toBe('Agent: main');
+    });
+    it('returns shared skills root when config is missing', async () => {
+        const base = await mkdtemp(join(tmpdir(), 'pilothub-pilotbot-missing-'));
+        const stateDir = join(base, 'state');
+        const configPath = join(base, 'missing', 'pilotbot.json');
+        process.env.PILOTBOT_STATE_DIR = stateDir;
+        process.env.PILOTBOT_CONFIG_PATH = configPath;
+        const { roots, labels } = await resolvePilotbotSkillRoots();
+        expect(roots).toEqual([resolve(stateDir, 'skills')]);
+        expect(labels[resolve(stateDir, 'skills')]).toBe('Shared skills');
+    });
+});
+//# sourceMappingURL=pilotbotConfig.test.js.map

package/dist/cli/pilotbotConfig.test.js.map

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

package/dist/cli/registry.d.ts

@@ -0,0 +1,7 @@
+import type { GlobalOpts } from './types.js';
+export declare const DEFAULT_SITE = "https://pilothub.com";
+export declare const DEFAULT_REGISTRY = "https://pilothub.com";
+export declare function resolveRegistry(opts: GlobalOpts): Promise<string>;
+export declare function getRegistry(opts: GlobalOpts, params?: {
+    cache?: boolean;
+}): Promise<string>;

package/dist/cli/registry.js

@@ -0,0 +1,42 @@
+import { readGlobalConfig, writeGlobalConfig } from '../config.js';
+import { discoverRegistryFromSite } from '../discovery.js';
+export const DEFAULT_SITE = 'https://pilothub.com';
+export const DEFAULT_REGISTRY = 'https://pilothub.com';
+const LEGACY_REGISTRY_HOSTS = new Set(['auth.pilothub.com']);
+export async function resolveRegistry(opts) {
+    const explicit = opts.registrySource !== 'default' ? opts.registry.trim() : '';
+    if (explicit)
+        return explicit;
+    const discovery = await discoverRegistryFromSite(opts.site).catch(() => null);
+    const discovered = discovery?.apiBase?.trim();
+    if (discovered)
+        return discovered;
+    const cfg = await readGlobalConfig();
+    const cached = cfg?.registry?.trim();
+    if (cached && !isLegacyRegistry(cached))
+        return cached;
+    return DEFAULT_REGISTRY;
+}
+export async function getRegistry(opts, params) {
+    const cache = params?.cache !== false;
+    const registry = await resolveRegistry(opts);
+    if (!cache)
+        return registry;
+    const cfg = await readGlobalConfig();
+    const cached = cfg?.registry?.trim();
+    const shouldUpdate = !cached ||
+        isLegacyRegistry(cached) ||
+        (cached === DEFAULT_REGISTRY && registry !== DEFAULT_REGISTRY);
+    if (shouldUpdate)
+        await writeGlobalConfig({ registry, token: cfg?.token });
+    return registry;
+}
+function isLegacyRegistry(registry) {
+    try {
+        return LEGACY_REGISTRY_HOSTS.has(new URL(registry).hostname);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/cli/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/cli/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AAG1D,MAAM,CAAC,MAAM,YAAY,GAAG,sBAAsB,CAAA;AAClD,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAA;AACtD,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAA;AAE5D,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAgB;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9E,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAE7B,MAAM,SAAS,GAAG,MAAM,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;IAC7E,MAAM,UAAU,GAAG,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC7C,IAAI,UAAU;QAAE,OAAO,UAAU,CAAA;IAEjC,MAAM,GAAG,GAAG,MAAM,gBAAgB,EAAE,CAAA;IACpC,MAAM,MAAM,GAAG,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IACpC,IAAI,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAA;IACtD,OAAO,gBAAgB,CAAA;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAgB,EAAE,MAA4B;IAC9E,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,KAAK,KAAK,CAAA;IACrC,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAA;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAA;IAC3B,MAAM,GAAG,GAAG,MAAM,gBAAgB,EAAE,CAAA;IACpC,MAAM,MAAM,GAAG,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IACpC,MAAM,YAAY,GAChB,CAAC,MAAM;QACP,gBAAgB,CAAC,MAAM,CAAC;QACxB,CAAC,MAAM,KAAK,gBAAgB,IAAI,QAAQ,KAAK,gBAAgB,CAAC,CAAA;IAChE,IAAI,YAAY;QAAE,MAAM,iBAAiB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;IAC1E,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,OAAO,qBAAqB,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAA;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC"}

package/dist/cli/registry.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/registry.test.js

@@ -0,0 +1,48 @@
+/* @vitest-environment node */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const readGlobalConfig = vi.fn();
+const writeGlobalConfig = vi.fn();
+const discoverRegistryFromSite = vi.fn();
+vi.mock('../config.js', () => ({
+    readGlobalConfig: (...args) => readGlobalConfig(...args),
+    writeGlobalConfig: (...args) => writeGlobalConfig(...args),
+}));
+vi.mock('../discovery.js', () => ({
+    discoverRegistryFromSite: (...args) => discoverRegistryFromSite(...args),
+}));
+const { DEFAULT_REGISTRY, getRegistry, resolveRegistry } = await import('./registry');
+function makeOpts(overrides = {}) {
+    return {
+        workdir: '/work',
+        dir: '/work/skills',
+        site: 'https://pilothub.com',
+        registry: DEFAULT_REGISTRY,
+        registrySource: 'default',
+        ...overrides,
+    };
+}
+beforeEach(() => {
+    readGlobalConfig.mockReset();
+    writeGlobalConfig.mockReset();
+    discoverRegistryFromSite.mockReset();
+});
+describe('registry resolution', () => {
+    it('prefers explicit registry over discovery/cache', async () => {
+        readGlobalConfig.mockResolvedValue({ registry: 'https://auth.pilothub.com' });
+        discoverRegistryFromSite.mockResolvedValue({ apiBase: 'https://pilothub.com' });
+        const registry = await resolveRegistry(makeOpts({ registry: 'https://custom.example', registrySource: 'cli' }));
+        expect(registry).toBe('https://custom.example');
+        expect(discoverRegistryFromSite).not.toHaveBeenCalled();
+    });
+    it('ignores legacy registry and updates cache from discovery', async () => {
+        readGlobalConfig.mockResolvedValue({ registry: 'https://auth.pilothub.com', token: 'tkn' });
+        discoverRegistryFromSite.mockResolvedValue({ apiBase: 'https://pilothub.com' });
+        const registry = await getRegistry(makeOpts(), { cache: true });
+        expect(registry).toBe('https://pilothub.com');
+        expect(writeGlobalConfig).toHaveBeenCalledWith({
+            registry: 'https://pilothub.com',
+            token: 'tkn',
+        });
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/dist/cli/registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.js","sourceRoot":"","sources":["../../src/cli/registry.test.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAG7D,MAAM,gBAAgB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;AAChC,MAAM,iBAAiB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;AACjC,MAAM,wBAAwB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;AAExC,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7B,gBAAgB,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IACnE,iBAAiB,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;CACtE,CAAC,CAAC,CAAA;AAEH,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,CAAC;IAChC,wBAAwB,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,wBAAwB,CAAC,GAAG,IAAI,CAAC;CACpF,CAAC,CAAC,CAAA;AAEH,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAA;AAErF,SAAS,QAAQ,CAAC,YAAiC,EAAE;IACnD,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,GAAG,EAAE,cAAc;QACnB,IAAI,EAAE,sBAAsB;QAC5B,QAAQ,EAAE,gBAAgB;QAC1B,cAAc,EAAE,SAAS;QACzB,GAAG,SAAS;KACb,CAAA;AACH,CAAC;AAED,UAAU,CAAC,GAAG,EAAE;IACd,gBAAgB,CAAC,SAAS,EAAE,CAAA;IAC5B,iBAAiB,CAAC,SAAS,EAAE,CAAA;IAC7B,wBAAwB,CAAC,SAAS,EAAE,CAAA;AACtC,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,gBAAgB,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,2BAA2B,EAAE,CAAC,CAAA;QAC7E,wBAAwB,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAA;QAE/E,MAAM,QAAQ,GAAG,MAAM,eAAe,CACpC,QAAQ,CAAC,EAAE,QAAQ,EAAE,wBAAwB,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CACxE,CAAA;QAED,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAA;QAC/C,MAAM,CAAC,wBAAwB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;IACzD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,gBAAgB,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,2BAA2B,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;QAC3F,wBAAwB,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAA;QAE/E,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAE/D,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;QAC7C,MAAM,CAAC,iBAAiB,CAAC,CAAC,oBAAoB,CAAC;YAC7C,QAAQ,EAAE,sBAAsB;YAChC,KAAK,EAAE,KAAK;SACb,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/cli/scanSkills.d.ts

@@ -0,0 +1,7 @@
+export type SkillFolder = {
+    folder: string;
+    slug: string;
+    displayName: string;
+};
+export declare function findSkillFolders(root: string): Promise<SkillFolder[]>;
+export declare function getFallbackSkillRoots(workdir: string): string[];

package/dist/cli/scanSkills.js

@@ -0,0 +1,75 @@
+import { readdir, stat } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { basename, join, resolve } from 'node:path';
+import { sanitizeSlug, titleCase } from './slug.js';
+export async function findSkillFolders(root) {
+    const absRoot = resolve(root);
+    const rootStat = await stat(absRoot).catch(() => null);
+    if (!rootStat || !rootStat.isDirectory())
+        return [];
+    const direct = await isSkillFolder(absRoot);
+    if (direct)
+        return [direct];
+    const entries = await readdir(absRoot, { withFileTypes: true }).catch(() => []);
+    const folders = entries
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => join(absRoot, entry.name));
+    const results = [];
+    for (const folder of folders) {
+        const found = await isSkillFolder(folder);
+        if (found)
+            results.push(found);
+    }
+    return results.sort((a, b) => a.slug.localeCompare(b.slug));
+}
+export function getFallbackSkillRoots(workdir) {
+    const home = homedir();
+    const roots = [
+        // adjacent repo installs
+        resolve(workdir, '..', 'pilotbot', 'skills'),
+        resolve(workdir, '..', 'pilotbot', 'Skills'),
+        resolve(workdir, '..', 'pilotbot', 'skills'),
+        resolve(workdir, '..', 'pilotbot', 'Skills'),
+        // legacy locations
+        resolve(home, 'pilot', 'skills'),
+        resolve(home, 'pilot', 'Skills'),
+        resolve(home, '.pilot', 'skills'),
+        resolve(home, '.pilot', 'Skills'),
+        resolve(home, 'pilotbot', 'skills'),
+        resolve(home, 'pilotbot', 'Skills'),
+        resolve(home, '.pilotbot', 'skills'),
+        resolve(home, '.pilotbot', 'Skills'),
+        resolve(home, 'pilotbot', 'skills'),
+        resolve(home, 'pilotbot', 'Skills'),
+        resolve(home, '.pilotbot', 'skills'),
+        resolve(home, '.pilotbot', 'Skills'),
+        // macOS App Support legacy
+        resolve(home, 'Library', 'Application Support', 'pilotbot', 'skills'),
+        resolve(home, 'Library', 'Application Support', 'pilotbot', 'Skills'),
+        resolve(home, 'Library', 'Application Support', 'pilotbot', 'skills'),
+        resolve(home, 'Library', 'Application Support', 'pilotbot', 'Skills'),
+    ];
+    return Array.from(new Set(roots));
+}
+async function isSkillFolder(folder) {
+    const marker = await findSkillMarker(folder);
+    if (!marker)
+        return null;
+    const base = basename(folder);
+    const slug = sanitizeSlug(base);
+    if (!slug)
+        return null;
+    const displayName = titleCase(base);
+    return { folder, slug, displayName };
+}
+async function findSkillMarker(folder) {
+    const candidates = ['SKILL.md', 'skill.md'];
+    for (const name of candidates) {
+        const path = join(folder, name);
+        const st = await stat(path).catch(() => null);
+        if (st?.isFile())
+            return path;
+    }
+    return null;
+}
+//# sourceMappingURL=scanSkills.js.map

package/dist/cli/scanSkills.js.map

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

package/dist/cli/scanSkills.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/scanSkills.test.js

@@ -0,0 +1,60 @@
+/* @vitest-environment node */
+import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { findSkillFolders, getFallbackSkillRoots } from './scanSkills';
+async function makeTmpDir() {
+    return mkdtemp(join(tmpdir(), 'pilothub-scan-'));
+}
+describe('scanSkills', () => {
+    it('detects a single skill folder (root contains SKILL.md)', async () => {
+        const root = await makeTmpDir();
+        try {
+            await writeFile(join(root, 'SKILL.md'), '# Skill\n', 'utf8');
+            const found = await findSkillFolders(root);
+            expect(found).toHaveLength(1);
+            expect(found[0]?.folder).toBe(resolve(root));
+            expect(found[0]?.slug).toBeTruthy();
+        }
+        finally {
+            await rm(root, { recursive: true, force: true });
+        }
+    });
+    it('detects skills in a skills directory (subfolders)', async () => {
+        const root = await makeTmpDir();
+        try {
+            const skillsDir = join(root, 'skills');
+            const folder = join(skillsDir, 'cool-skill');
+            await mkdir(folder, { recursive: true });
+            await writeFile(join(folder, 'SKILL.md'), '# Skill\n', 'utf8');
+            const found = await findSkillFolders(skillsDir);
+            expect(found).toHaveLength(1);
+            expect(found[0]?.slug).toBe('cool-skill');
+            expect(found[0]?.folder).toBe(resolve(folder));
+        }
+        finally {
+            await rm(root, { recursive: true, force: true });
+        }
+    });
+    it('ignores plural skills.md marker files', async () => {
+        const root = await makeTmpDir();
+        try {
+            const folder = join(root, 'docs');
+            await mkdir(folder, { recursive: true });
+            await writeFile(join(folder, 'skills.md'), '# Docs\n', 'utf8');
+            const found = await findSkillFolders(root);
+            expect(found).toHaveLength(0);
+        }
+        finally {
+            await rm(root, { recursive: true, force: true });
+        }
+    });
+    it('includes known legacy roots', () => {
+        const roots = getFallbackSkillRoots('/tmp/anywhere');
+        expect(roots.some((p) => p.endsWith('/pilotbot/skills'))).toBe(true);
+        expect(roots.some((p) => p.endsWith('/pilot/skills'))).toBe(true);
+        expect(roots.some((p) => p.endsWith('/pilotbot/skills'))).toBe(true);
+    });
+});
+//# sourceMappingURL=scanSkills.test.js.map

package/dist/cli/scanSkills.test.js.map

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

package/dist/cli/slug.d.ts

@@ -0,0 +1,2 @@
+export declare function sanitizeSlug(value: string): string;
+export declare function titleCase(value: string): string;

package/dist/cli/slug.js

@@ -0,0 +1,16 @@
+export function sanitizeSlug(value) {
+    const raw = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, '-');
+    const cleaned = raw.replace(/^-+/, '').replace(/-+$/, '').replace(/--+/g, '-');
+    return cleaned;
+}
+export function titleCase(value) {
+    return value
+        .trim()
+        .replace(/[-_]+/g, ' ')
+        .replace(/\s+/g, ' ')
+        .replace(/\b\w/g, (char) => char.toUpperCase());
+}
+//# sourceMappingURL=slug.js.map

package/dist/cli/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/cli/slug.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,GAAG,GAAG,KAAK;SACd,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAA;IAC/B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC9E,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK;SACT,IAAI,EAAE;SACN,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;AACnD,CAAC"}

package/dist/cli/types.d.ts

@@ -0,0 +1,15 @@
+export type GlobalOpts = {
+    workdir: string;
+    dir: string;
+    site: string;
+    registry: string;
+    registrySource: 'cli' | 'env' | 'default';
+};
+export type ResolveResult = {
+    match: {
+        version: string;
+    } | null;
+    latestVersion: {
+        version: string;
+    } | null;
+};

package/dist/cli/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":""}

package/dist/cli/ui.d.ts

@@ -0,0 +1,7 @@
+export declare function promptHidden(prompt: string): Promise<string>;
+export declare function promptConfirm(prompt: string): Promise<boolean>;
+export declare function openInBrowser(url: string): void;
+export declare function isInteractive(): boolean;
+export declare function createSpinner(text: string): import("ora").Ora;
+export declare function formatError(error: unknown): string;
+export declare function fail(message: string): never;