skillspace 0.7.0

package/dist/cli/commands/moderation.js

@@ -0,0 +1,161 @@
+import { isCancel, select } from "@clack/prompts";
+import { apiRequest, registryUrl } from "../../http.js";
+import { ApiRoutes, ApiV1BanUserResponseSchema, ApiV1SetRoleResponseSchema, ApiV1UserSearchResponseSchema, parseArk, } from "../../schema/index.js";
+import { requireAuthToken } from "../authToken.js";
+import { getRegistry } from "../registry.js";
+import { createSpinner, fail, formatError, isInteractive, promptConfirm } from "../ui.js";
+export async function cmdBanUser(opts, identifierArg, options, inputAllowed) {
+    const raw = identifierArg.trim();
+    if (!raw)
+        fail("Handle or user id required");
+    const reason = options.reason?.trim() || undefined;
+    const token = await requireAuthToken();
+    const registry = await getRegistry(opts, { cache: true });
+    const allowPrompt = isInteractive() && inputAllowed !== false;
+    const resolved = await resolveUserIdentifier(registry, token, raw, { id: options.id, fuzzy: options.fuzzy }, allowPrompt);
+    if (!resolved)
+        return;
+    if (!options.yes) {
+        if (!allowPrompt)
+            fail("Pass --yes (no input)");
+        const ok = await promptConfirm(`Ban ${resolved.label}? (requires moderator/admin; deletes owned skills)`);
+        if (!ok)
+            return;
+    }
+    const spinner = createSpinner(`Banning ${resolved.label}`);
+    try {
+        const result = await apiRequest(registry, {
+            method: "POST",
+            path: `${ApiRoutes.users}/ban`,
+            token,
+            body: resolved.userId
+                ? { userId: resolved.userId, reason }
+                : { handle: resolved.handle, reason },
+        }, ApiV1BanUserResponseSchema);
+        const parsed = parseArk(ApiV1BanUserResponseSchema, result, "Ban user response");
+        if (parsed.alreadyBanned) {
+            spinner.succeed(`OK. ${resolved.label} already banned`);
+            return parsed;
+        }
+        spinner.succeed(`OK. Banned ${resolved.label} (${formatDeletedSkills(parsed.deletedSkills)})`);
+        return parsed;
+    }
+    catch (error) {
+        spinner.fail(formatError(error));
+        throw error;
+    }
+}
+export async function cmdSetRole(opts, identifierArg, roleArg, options, inputAllowed) {
+    const raw = identifierArg.trim();
+    if (!raw)
+        fail("Handle or user id required");
+    const role = normalizeRole(roleArg);
+    const token = await requireAuthToken();
+    const registry = await getRegistry(opts, { cache: true });
+    const allowPrompt = isInteractive() && inputAllowed !== false;
+    const resolved = await resolveUserIdentifier(registry, token, raw, { id: options.id, fuzzy: options.fuzzy }, allowPrompt);
+    if (!resolved)
+        return;
+    if (!options.yes) {
+        if (!allowPrompt)
+            fail("Pass --yes (no input)");
+        const ok = await promptConfirm(`Set role for ${resolved.label} to ${role}? (admin only)`);
+        if (!ok)
+            return;
+    }
+    const spinner = createSpinner(`Setting role for ${resolved.label}`);
+    try {
+        const result = await apiRequest(registry, {
+            method: "POST",
+            path: `${ApiRoutes.users}/role`,
+            token,
+            body: resolved.userId
+                ? { userId: resolved.userId, role }
+                : { handle: resolved.handle, role },
+        }, ApiV1SetRoleResponseSchema);
+        const parsed = parseArk(ApiV1SetRoleResponseSchema, result, "Set role response");
+        spinner.succeed(`OK. ${resolved.label} is now ${parsed.role}`);
+        return parsed;
+    }
+    catch (error) {
+        spinner.fail(formatError(error));
+        throw error;
+    }
+}
+function normalizeHandle(value) {
+    const trimmed = value.trim();
+    return trimmed.startsWith("@") ? trimmed.slice(1).toLowerCase() : trimmed.toLowerCase();
+}
+async function resolveUserIdentifier(registry, token, raw, options, allowPrompt) {
+    const usesId = Boolean(options.id);
+    if (usesId) {
+        return { handle: null, userId: raw, label: raw };
+    }
+    const handle = normalizeHandle(raw);
+    if (!options.fuzzy) {
+        return { handle, userId: null, label: `@${handle}` };
+    }
+    const matches = await searchUsers(registry, token, raw);
+    if (matches.items.length === 0) {
+        fail(`No users matched "${raw}".`);
+    }
+    if (matches.items.length === 1) {
+        const match = matches.items[0];
+        return {
+            handle: match.handle ?? null,
+            userId: match.userId,
+            label: formatUserLabel(match),
+        };
+    }
+    if (!allowPrompt) {
+        fail(`Multiple users matched "${raw}". Use --id.\n${formatUserList(matches.items)}`);
+    }
+    const choice = await select({
+        message: `Select a user for "${raw}"`,
+        options: matches.items.map((item) => ({
+            value: item.userId,
+            label: formatUserLabel(item),
+        })),
+    });
+    if (isCancel(choice))
+        return null;
+    const selected = matches.items.find((item) => item.userId === choice);
+    if (!selected)
+        return null;
+    return {
+        handle: selected.handle ?? null,
+        userId: selected.userId,
+        label: formatUserLabel(selected),
+    };
+}
+async function searchUsers(registry, token, query) {
+    const url = registryUrl(ApiRoutes.users, registry);
+    url.searchParams.set("q", query.trim());
+    url.searchParams.set("limit", "10");
+    const result = await apiRequest(registry, { method: "GET", url: url.toString(), token }, ApiV1UserSearchResponseSchema);
+    return parseArk(ApiV1UserSearchResponseSchema, result, "User search response");
+}
+function formatUserLabel(user) {
+    const handle = user.handle ? `@${user.handle}` : "unknown";
+    const name = user.displayName ?? user.name;
+    const role = user.role ? ` (${user.role})` : "";
+    const label = name ? `${handle} — ${name}` : handle;
+    return `${label}${role} · ${user.userId}`;
+}
+function formatUserList(users) {
+    return users.map((user) => `- ${formatUserLabel(user)}`).join("\n");
+}
+function normalizeRole(value) {
+    const role = value.trim().toLowerCase();
+    if (role === "user" || role === "moderator" || role === "admin")
+        return role;
+    fail("Role must be user|moderator|admin");
+}
+function formatDeletedSkills(count) {
+    if (!Number.isFinite(count))
+        return "deleted skills unknown";
+    if (count === 1)
+        return "deleted 1 skill";
+    return `deleted ${count} skills`;
+}
+//# sourceMappingURL=moderation.js.map

package/dist/cli/commands/moderation.js.map

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

package/dist/cli/commands/publish.d.ts

@@ -0,0 +1,9 @@
+import type { GlobalOpts } from "../types.js";
+export declare function cmdPublish(opts: GlobalOpts, folderArg: string, options: {
+    slug?: string;
+    name?: string;
+    version?: string;
+    changelog?: string;
+    tags?: string;
+    forkOf?: string;
+}): Promise<void>;

package/dist/cli/commands/publish.js

@@ -0,0 +1,85 @@
+import { stat } from "node:fs/promises";
+import { basename, resolve } from "node:path";
+import semver from "semver";
+import { apiRequestForm } from "../../http.js";
+import { ApiRoutes, ApiV1PublishResponseSchema } from "../../schema/index.js";
+import { listTextFiles } from "../../skills.js";
+import { requireAuthToken } from "../authToken.js";
+import { getRegistry } from "../registry.js";
+import { sanitizeSlug, titleCase } from "../slug.js";
+import { createSpinner, fail, formatError } from "../ui.js";
+export async function cmdPublish(opts, folderArg, options) {
+    const folder = folderArg ? resolve(opts.workdir, folderArg) : null;
+    if (!folder)
+        fail("Path required");
+    const folderStat = await stat(folder).catch(() => null);
+    if (!folderStat || !folderStat.isDirectory())
+        fail("Path must be a folder");
+    const token = await requireAuthToken();
+    const registry = await getRegistry(opts, { cache: true });
+    const slug = options.slug ?? sanitizeSlug(basename(folder));
+    const displayName = options.name ?? titleCase(basename(folder));
+    const version = options.version;
+    const changelog = options.changelog ?? "";
+    const tagsValue = options.tags ?? "latest";
+    const tags = tagsValue
+        .split(",")
+        .map((tag) => tag.trim())
+        .filter(Boolean);
+    const forkOfRaw = options.forkOf?.trim();
+    const forkOf = forkOfRaw ? parseForkOf(forkOfRaw) : undefined;
+    if (!slug)
+        fail("--slug required");
+    if (!displayName)
+        fail("--name required");
+    if (!version || !semver.valid(version))
+        fail("--version must be valid semver");
+    const spinner = createSpinner(`Preparing ${slug}@${version}`);
+    try {
+        const filesOnDisk = await listTextFiles(folder);
+        if (filesOnDisk.length === 0)
+            fail("No files found");
+        if (!filesOnDisk.some((file) => {
+            const lower = file.relPath.toLowerCase();
+            return lower === "skill.md" || lower === "skills.md";
+        })) {
+            fail("SKILL.md required");
+        }
+        const form = new FormData();
+        form.set("payload", JSON.stringify({
+            slug,
+            displayName,
+            version,
+            changelog,
+            acceptLicenseTerms: true,
+            tags,
+            ...(forkOf ? { forkOf } : {}),
+        }));
+        let index = 0;
+        for (const file of filesOnDisk) {
+            index += 1;
+            spinner.text = `Uploading ${file.relPath} (${index}/${filesOnDisk.length})`;
+            const blob = new Blob([Buffer.from(file.bytes)], { type: file.contentType ?? "text/plain" });
+            form.append("files", blob, file.relPath);
+        }
+        spinner.text = `Publishing ${slug}@${version}`;
+        const result = await apiRequestForm(registry, { method: "POST", path: ApiRoutes.skills, token, form }, ApiV1PublishResponseSchema);
+        spinner.succeed(`OK. Published ${slug}@${version} (${result.versionId})`);
+    }
+    catch (error) {
+        spinner.fail(formatError(error));
+        throw error;
+    }
+}
+function parseForkOf(value) {
+    const trimmed = value.trim();
+    const [slugRaw, versionRaw] = trimmed.split("@");
+    const slug = (slugRaw ?? "").trim().toLowerCase();
+    if (!slug)
+        fail("--fork-of must be <slug> or <slug@version>");
+    const version = (versionRaw ?? "").trim();
+    if (version && !semver.valid(version))
+        fail("--fork-of version must be valid semver");
+    return { slug, version: version || undefined };
+}
+//# sourceMappingURL=publish.js.map

package/dist/cli/commands/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../../src/cli/commands/publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5D,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAgB,EAChB,SAAiB,EACjB,OAOC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,IAAI,CAAC,MAAM;QAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE;QAAE,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAE5E,MAAM,KAAK,GAAG,MAAM,gBAAgB,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,IAAI,QAAQ,CAAC;IAC3C,MAAM,IAAI,GAAG,SAAS;SACnB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9D,IAAI,CAAC,IAAI;QAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACnC,IAAI,CAAC,WAAW;QAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAE/E,MAAM,OAAO,GAAG,aAAa,CAAC,aAAa,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACrD,IACE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACzC,OAAO,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,WAAW,CAAC;QACvD,CAAC,CAAC,EACF,CAAC;YACD,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC5B,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,GAAG,CACN,SAAS,EACT,IAAI,CAAC,SAAS,CAAC;YACb,IAAI;YACJ,WAAW;YACX,OAAO;YACP,SAAS;YACT,kBAAkB,EAAE,IAAI;YACxB,IAAI;YACJ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,CAAC,CACH,CAAC;QAEF,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,KAAK,IAAI,CAAC,CAAC;YACX,OAAO,CAAC,IAAI,GAAG,aAAa,IAAI,CAAC,OAAO,KAAK,KAAK,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YAC5E,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,IAAI,YAAY,EAAE,CAAC,CAAC;YAC7F,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,CAAC,IAAI,GAAG,cAAc,IAAI,IAAI,OAAO,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,QAAQ,EACR,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EACvD,0BAA0B,CAC3B,CAAC;QAEF,OAAO,CAAC,OAAO,CAAC,iBAAiB,IAAI,IAAI,OAAO,KAAK,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACjC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClD,IAAI,CAAC,IAAI;QAAE,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACtF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,CAAC;AACjD,CAAC"}

package/dist/cli/commands/skills.d.ts

@@ -0,0 +1,26 @@
+import type { GlobalOpts } from "../types.js";
+export declare function cmdSearch(opts: GlobalOpts, query: string, limit?: number): Promise<void>;
+export declare function cmdInstall(opts: GlobalOpts, slug: string, versionFlag?: string, force?: boolean): Promise<void>;
+export declare function cmdUpdate(opts: GlobalOpts, slugArg: string | undefined, options: {
+    all?: boolean;
+    version?: string;
+    force?: boolean;
+}, inputAllowed: boolean): Promise<void>;
+export declare function cmdList(opts: GlobalOpts): Promise<void>;
+export declare function cmdUninstall(opts: GlobalOpts, slug: string, options: {
+    yes?: boolean;
+} | undefined, inputAllowed: boolean): Promise<void>;
+export declare function cmdExplore(opts: GlobalOpts, options?: {
+    limit?: number;
+    sort?: string;
+    json?: boolean;
+}): Promise<void>;
+export declare function formatExploreLine(item: {
+    slug: string;
+    summary?: string | null;
+    updatedAt: number;
+    latestVersion?: {
+        version: string;
+    } | null;
+}): string;
+export declare function clampLimit(limit: number, fallback?: number): number;