@pi-harness/pi-harness 0.1.2 → 0.1.3

package/packages/api-gateway/src/marketplace-entries/official/telemetry-blocker.json

@@ -0,0 +1,16 @@
+{
+  "id": "telemetry-blocker",
+  "packageName": "@pi-harness/core/plugins/telemetry-blocker",
+  "version": "0.1.2",
+  "name": "Telemetry Blocker",
+  "description": "Block configured outbound telemetry destinations and report blocked attempts without collecting payload contents.",
+  "author": "Pi Harness",
+  "repository": "https://github.com/pi-harness/pi-harness",
+  "license": "MIT",
+  "source": "official",
+  "status": "verified",
+  "category": { "id": "security", "label": "安全" },
+  "capabilities": ["telemetry policy", "outbound blocking", "privacy"],
+  "hooks": ["network policy", "plugin UI"],
+  "profile": { "name": "@pi-harness/core/plugins/telemetry-blocker", "config": {} }
+}

package/packages/api-gateway/src/marketplace-entries/official/test-harness.json

@@ -0,0 +1,16 @@
+{
+  "id": "test-harness",
+  "packageName": "@pi-harness/core/plugins/test-harness",
+  "version": "0.1.2",
+  "name": "Test Harness",
+  "description": "Run bounded project test commands and report exit status, output, and duration without shell interpolation.",
+  "author": "Pi Harness",
+  "repository": "https://github.com/pi-harness/pi-harness",
+  "license": "MIT",
+  "source": "official",
+  "status": "verified",
+  "category": { "id": "testing", "label": "测试" },
+  "capabilities": ["test runner", "command output", "duration metrics"],
+  "hooks": ["workspace commands", "plugin UI"],
+  "profile": { "name": "@pi-harness/core/plugins/test-harness", "config": {} }
+}

package/packages/api-gateway/src/marketplace-entries/official/theme-studio.json

@@ -0,0 +1,19 @@
+{
+  "id": "theme-studio",
+  "packageName": "@pi-harness/core/plugins/theme-studio",
+  "version": "0.1.2",
+  "name": "Theme Studio",
+  "description": "Apply bounded Light, Midnight, Paper, and High Contrast presets to the Pi Harness web surface.",
+  "author": "Pi Harness",
+  "repository": "https://github.com/pi-harness/pi-harness",
+  "license": "MIT",
+  "source": "official",
+  "status": "verified",
+  "category": { "id": "interface", "label": "界面增强" },
+  "capabilities": ["theme presets", "contrast modes", "session persistence"],
+  "hooks": ["session lifecycle", "React root tokens", "plugin UI"],
+  "profile": {
+    "name": "@pi-harness/core/plugins/theme-studio",
+    "config": { "theme": "light" }
+  }
+}

package/packages/api-gateway/src/marketplace-entries/official/token-guard.json

@@ -0,0 +1,16 @@
+{
+  "id": "token-guard",
+  "packageName": "@pi-harness/core/plugins/token-guard",
+  "version": "0.1.2",
+  "name": "Token Guard",
+  "description": "Monitor context usage and stop runs when the configured token budget threshold is reached.",
+  "author": "Pi Harness",
+  "repository": "https://github.com/pi-harness/pi-harness",
+  "license": "MIT",
+  "source": "official",
+  "status": "verified",
+  "category": { "id": "observability", "label": "可观测性" },
+  "capabilities": ["token budget", "per-run token budget", "context monitoring"],
+  "hooks": ["session event", "plugin UI"],
+  "profile": { "name": "@pi-harness/core/plugins/token-guard", "config": { "maxPercent": 90, "maxRunTokens": 0 } }
+}

package/packages/api-gateway/src/marketplace-entries/official/turn-rewind.json

@@ -0,0 +1,22 @@
+{
+  "id": "turn-rewind",
+  "packageName": "@pi-harness/core/plugins/turn-rewind",
+  "version": "0.1.2",
+  "name": "Turn Rewind",
+  "description": "Navigate the native Pi session tree back to a prior user turn while preserving the abandoned branch.",
+  "author": "Pi Harness",
+  "repository": "https://github.com/pi-harness/pi-harness",
+  "license": "MIT",
+  "source": "official",
+  "status": "verified",
+  "category": {
+    "id": "workflow",
+    "label": "工作流"
+  },
+  "capabilities": ["session rewind", "branching", "recovery"],
+  "hooks": ["session tree", "plugin UI"],
+  "profile": {
+    "name": "@pi-harness/core/plugins/turn-rewind",
+    "config": {}
+  }
+}

package/packages/api-gateway/src/marketplace-entries/official/undo-savepoint.json

@@ -0,0 +1,16 @@
+{
+  "id": "undo-savepoint",
+  "packageName": "@pi-harness/core/plugins/undo-savepoint",
+  "version": "0.1.2",
+  "name": "Undo Savepoints",
+  "description": "Create inspectable savepoints before agent changes so the workspace can be restored safely.",
+  "author": "Pi Harness",
+  "repository": "https://github.com/pi-harness/pi-harness",
+  "license": "MIT",
+  "source": "official",
+  "status": "verified",
+  "category": { "id": "workflow", "label": "工作流" },
+  "capabilities": ["savepoint", "recovery"],
+  "hooks": ["tool execution", "plugin UI"],
+  "profile": { "name": "@pi-harness/core/plugins/undo-savepoint", "config": {} }
+}

package/packages/api-gateway/src/marketplace-entries/official/vision-toolkit.json

@@ -0,0 +1,16 @@
+{
+  "id": "vision-toolkit",
+  "packageName": "@pi-harness/core/plugins/vision-toolkit",
+  "version": "0.1.2",
+  "name": "Vision Toolkit",
+  "description": "Catalog workspace images and inspect safe metadata such as MIME type, size, and dimensions.",
+  "author": "Pi Harness",
+  "repository": "https://github.com/pi-harness/pi-harness",
+  "license": "MIT",
+  "source": "official",
+  "status": "verified",
+  "category": { "id": "multimodal", "label": "视觉与多模态" },
+  "capabilities": ["image catalog", "metadata", "vision"],
+  "hooks": ["workspace access", "plugin UI"],
+  "profile": { "name": "@pi-harness/core/plugins/vision-toolkit", "config": {} }
+}

package/packages/api-gateway/src/marketplace-entries/official/web-research.json

@@ -0,0 +1,16 @@
+{
+  "id": "web-research",
+  "packageName": "@pi-harness/core/plugins/web-research",
+  "version": "0.1.2",
+  "name": "Web Research",
+  "description": "Search the public web through a configurable provider and return bounded, cited source evidence.",
+  "author": "Pi Harness",
+  "repository": "https://github.com/pi-harness/pi-harness",
+  "license": "MIT",
+  "source": "official",
+  "status": "verified",
+  "category": { "id": "web", "label": "网页与研究" },
+  "capabilities": ["web search", "citations", "research"],
+  "hooks": ["network request", "plugin UI"],
+  "profile": { "name": "@pi-harness/core/plugins/web-research", "config": {} }
+}

package/packages/api-gateway/src/marketplace-entries/official/workspace-navigator.json

@@ -0,0 +1,16 @@
+{
+  "id": "workspace-navigator",
+  "packageName": "@pi-harness/core/plugins/workspace-navigator",
+  "version": "0.1.2",
+  "name": "Workspace Navigator",
+  "description": "Show a bounded workspace tree and read-only Git status for a high-signal coding sidebar.",
+  "author": "Pi Harness",
+  "repository": "https://github.com/pi-harness/pi-harness",
+  "license": "MIT",
+  "source": "official",
+  "status": "verified",
+  "category": { "id": "developer", "label": "开发工具" },
+  "capabilities": ["workspace navigation", "directory tree", "Git status", "sidebar context"],
+  "hooks": ["workspace files", "bounded scan", "read-only Git", "plugin UI"],
+  "profile": { "name": "@pi-harness/core/plugins/workspace-navigator", "config": {} }
+}

package/packages/api-gateway/src/marketplace-entries/official/workspace-search.json

@@ -0,0 +1,16 @@
+{
+  "id": "workspace-search",
+  "packageName": "@pi-harness/core/plugins/workspace-search",
+  "version": "0.1.2",
+  "name": "Workspace Search",
+  "description": "Search bounded text files in the active workspace with ignored directories and binary content excluded.",
+  "author": "Pi Harness",
+  "repository": "https://github.com/pi-harness/pi-harness",
+  "license": "MIT",
+  "source": "official",
+  "status": "verified",
+  "category": { "id": "context", "label": "上下文" },
+  "capabilities": ["workspace search", "file discovery", "context lookup"],
+  "hooks": ["workspace files", "plugin UI"],
+  "profile": { "name": "@pi-harness/core/plugins/workspace-search", "config": {} }
+}

package/packages/api-gateway/src/marketplace-entries/official/yaml-validator.json

@@ -0,0 +1,16 @@
+{
+  "id": "yaml-validator",
+  "packageName": "@pi-harness/core/plugins/yaml-validator",
+  "version": "0.1.2",
+  "name": "YAML Validator",
+  "description": "Validate bounded YAML configuration files and return precise parse errors without rewriting the source.",
+  "author": "Pi Harness",
+  "repository": "https://github.com/pi-harness/pi-harness",
+  "license": "MIT",
+  "source": "official",
+  "status": "verified",
+  "category": { "id": "developer", "label": "开发工具" },
+  "capabilities": ["YAML validation", "config diagnostics", "parse errors"],
+  "hooks": ["workspace files", "plugin UI"],
+  "profile": { "name": "@pi-harness/core/plugins/yaml-validator", "config": {} }
+}

package/packages/api-gateway/src/marketplace.ts

@@ -1,4 +1,6 @@
-import registry from "./marketplace-registry.json" with { type: "json" };
+import { readdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 
 export interface MarketplacePlugin {
   readonly id: string;
@@ -11,38 +13,281 @@ export interface MarketplacePlugin {
   readonly license: string;
   readonly source: "official" | "community";
   readonly status: "verified" | "experimental";
+  readonly category: { readonly id: string; readonly label: string };
   readonly capabilities: readonly string[];
   readonly hooks: readonly string[];
-  readonly profile: { readonly name: string; readonly config: Record<string, unknown> };
+  readonly profile: { readonly name: string; readonly config: Record<string, unknown> | readonly unknown[]; readonly group?: boolean };
+  readonly statistics?: MarketplaceStatistics;
 }
 
-const npmPackagePattern = /^(?:@[a-z0-9._~-]+\/)?[a-z0-9._~-]+$/;
+export interface MarketplaceStatistics {
+  readonly downloads30d?: number;
+  readonly quality?: number;
+  readonly updatedAt?: string;
+}
+
+export type MarketplaceStatisticsFetcher = (url: string, init?: RequestInit) => Promise<Response>;
+
+export interface MarketplaceStatisticsLoaderOptions {
+  readonly failureTtlMs?: number;
+  readonly fetcher?: MarketplaceStatisticsFetcher;
+  readonly now?: () => number;
+  readonly timeoutMs?: number;
+  readonly ttlMs?: number;
+}
+
+interface NpmPackageStatisticsResult {
+  readonly failed: boolean;
+  readonly statistics?: MarketplaceStatistics;
+}
+
+export interface MarketplacePage {
+  readonly items: readonly MarketplacePlugin[];
+  readonly total: number;
+  readonly page: number;
+  readonly pageSize: number;
+  readonly hasNext: boolean;
+}
+
+export interface MarketplaceCategory {
+  readonly id: string;
+  readonly label: string;
+  readonly count: number;
+}
+
+const npmPackagePattern = /^(?:@[a-z0-9._~-]+\/)?[a-z0-9._~-]+(?:\/[a-z0-9._~-]+)*$/;
+const entryIdPattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const versionPattern = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
+const categoryIdPattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
 
 function isMarketplacePlugin(value: unknown): value is MarketplacePlugin {
-  if (value === null || typeof value !== "object") return false;
-  const item = value as Partial<MarketplacePlugin>;
-  return typeof item.id === "string" && /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(item.id)
-    && typeof item.packageName === "string" && npmPackagePattern.test(item.packageName)
-    && typeof item.version === "string" && /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(item.version)
-    && typeof item.name === "string" && typeof item.description === "string" && typeof item.author === "string"
-    && typeof item.repository === "string" && item.repository.startsWith("https://") && typeof item.license === "string"
-    && (item.source === "official" || item.source === "community") && (item.status === "verified" || item.status === "experimental")
-    && Array.isArray(item.capabilities) && item.capabilities.every((entry) => typeof entry === "string")
-    && Array.isArray(item.hooks) && item.hooks.every((entry) => typeof entry === "string")
-    && item.profile !== undefined && typeof item.profile === "object" && typeof item.profile.name === "string"
-    && item.profile.config !== undefined && typeof item.profile.config === "object";
-}
-
-export const MARKETPLACE_PLUGINS: readonly MarketplacePlugin[] = (registry as unknown[]).filter(isMarketplacePlugin);
-
-export function searchMarketplace(query = "", capability = ""): readonly MarketplacePlugin[] {
+  if (!isRecord(value)) return false;
+  const profile = value.profile;
+  const category = value.category;
+  return (
+    typeof value.id === "string" &&
+    entryIdPattern.test(value.id) &&
+    typeof value.packageName === "string" &&
+    npmPackagePattern.test(value.packageName) &&
+    typeof value.version === "string" &&
+    versionPattern.test(value.version) &&
+    typeof value.name === "string" &&
+    value.name.trim() !== "" &&
+    typeof value.description === "string" &&
+    value.description.trim() !== "" &&
+    typeof value.author === "string" &&
+    value.author.trim() !== "" &&
+    typeof value.repository === "string" &&
+    value.repository.startsWith("https://") &&
+    typeof value.license === "string" &&
+    value.license.trim() !== "" &&
+    (value.source === "official" || value.source === "community") &&
+    (value.status === "verified" || value.status === "experimental") &&
+    isRecord(category) &&
+    typeof category.id === "string" &&
+    categoryIdPattern.test(category.id) &&
+    typeof category.label === "string" &&
+    category.label.trim() !== "" &&
+    Array.isArray(value.capabilities) &&
+    value.capabilities.length > 0 &&
+    value.capabilities.every((entry) => typeof entry === "string" && entry.trim() !== "") &&
+    Array.isArray(value.hooks) &&
+    value.hooks.length > 0 &&
+    value.hooks.every((entry) => typeof entry === "string" && entry.trim() !== "") &&
+    isRecord(profile) &&
+    typeof profile.name === "string" &&
+    profile.name === value.packageName &&
+    (profile.group !== true ? isRecord(profile.config) : Array.isArray(profile.config))
+  );
+}
+
+function entryFiles(directory: string): string[] {
+  return readdirSync(directory, { withFileTypes: true }).flatMap((entry) => {
+    const path = join(directory, entry.name);
+    if (entry.isDirectory()) return entryFiles(path);
+    return entry.isFile() && entry.name.endsWith(".json") ? [path] : [];
+  });
+}
+
+function loadMarketplacePlugins(): readonly MarketplacePlugin[] {
+  const directory = join(dirname(fileURLToPath(import.meta.url)), "marketplace-entries");
+  const plugins = entryFiles(directory)
+    .sort()
+    .map((path) => {
+      let value: unknown;
+      try {
+        value = JSON.parse(readFileSync(path, "utf8")) as unknown;
+      } catch (error) {
+        throw new Error(`Invalid marketplace entry ${path}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+      }
+      if (!isMarketplacePlugin(value)) throw new Error(`Invalid marketplace entry: ${path}`);
+      return value;
+    });
+  const ids = new Set<string>();
+  const packages = new Set<string>();
+  for (const plugin of plugins) {
+    if (ids.has(plugin.id)) throw new Error(`Duplicate marketplace id: ${plugin.id}`);
+    if (packages.has(plugin.packageName)) throw new Error(`Duplicate marketplace package: ${plugin.packageName}`);
+    ids.add(plugin.id);
+    packages.add(plugin.packageName);
+  }
+  return plugins;
+}
+
+export const MARKETPLACE_PLUGINS: readonly MarketplacePlugin[] = loadMarketplacePlugins();
+
+export function needsMarketplacePackageInstall(plugin: MarketplacePlugin): boolean {
+  return !plugin.packageName.startsWith("@pi-harness/core/plugins/");
+}
+
+export function marketplaceNpmPackageName(packageName: string): string {
+  const segments = packageName.split("/");
+  return packageName.startsWith("@") ? segments.slice(0, 2).join("/") : (segments[0] ?? packageName);
+}
+
+function validUnitScore(value: unknown): value is number {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0 && value <= 1;
+}
+
+function validDate(value: unknown): value is string {
+  return typeof value === "string" && Number.isFinite(Date.parse(value));
+}
+
+async function fetchNpmPackageStatistics(packageName: string, fetcher: MarketplaceStatisticsFetcher, timeoutMs: number): Promise<NpmPackageStatisticsResult> {
+  let searchResponse: Response;
+  try {
+    const query = new URLSearchParams({ text: packageName, size: "20" });
+    searchResponse = await fetcher(`https://registry.npmjs.org/-/v1/search?${query}`, { signal: AbortSignal.timeout(timeoutMs) });
+  } catch {
+    return { failed: true };
+  }
+  if (!searchResponse.ok) return { failed: true };
+  let searchPayload: unknown;
+  try {
+    searchPayload = (await searchResponse.json()) as unknown;
+  } catch {
+    return { failed: true };
+  }
+  if (!isRecord(searchPayload) || !Array.isArray(searchPayload.objects)) return { failed: true };
+  const objects: unknown[] = searchPayload.objects;
+  const exact: unknown = objects.find((item) => isRecord(item) && isRecord(item.package) && item.package.name === packageName);
+  if (!isRecord(exact) || !isRecord(exact.package)) return { failed: false };
+  const detail = isRecord(exact.score) && isRecord(exact.score.detail) ? exact.score.detail : undefined;
+  const statistics: { downloads30d?: number; quality?: number; updatedAt?: string } = {};
+  if (detail && validUnitScore(detail.quality)) statistics.quality = detail.quality;
+  if (validDate(exact.package.date)) statistics.updatedAt = exact.package.date;
+  let failed = false;
+  try {
+    const downloadResponse = await fetcher(`https://api.npmjs.org/downloads/point/last-month/${encodeURIComponent(packageName)}`, {
+      signal: AbortSignal.timeout(timeoutMs),
+    });
+    if (downloadResponse.ok) {
+      const downloadPayload = (await downloadResponse.json()) as unknown;
+      if (
+        isRecord(downloadPayload) &&
+        typeof downloadPayload.downloads === "number" &&
+        Number.isSafeInteger(downloadPayload.downloads) &&
+        downloadPayload.downloads >= 0
+      )
+        statistics.downloads30d = downloadPayload.downloads;
+      else failed = true;
+    } else failed = true;
+  } catch {
+    // Download counts are optional when the npm statistics service is unavailable.
+    failed = true;
+  }
+  return { failed, statistics };
+}
+
+export function createMarketplaceStatisticsLoader(options: MarketplaceStatisticsLoaderOptions = {}) {
+  const fetcher = options.fetcher ?? ((url: string, init?: RequestInit) => globalThis.fetch(url, init));
+  const failureTtlMs = options.failureTtlMs ?? 60_000;
+  const now = options.now ?? Date.now;
+  const timeoutMs = options.timeoutMs ?? 3_000;
+  const ttlMs = options.ttlMs ?? 6 * 60 * 60 * 1_000;
+  const cache = new Map<string, { readonly expiresAt: number; readonly result: NpmPackageStatisticsResult }>();
+  const inFlight = new Map<string, Promise<NpmPackageStatisticsResult>>();
+  const loadPackage = async (packageName: string): Promise<NpmPackageStatisticsResult> => {
+    const timestamp = now();
+    const cached = cache.get(packageName);
+    if (cached !== undefined && cached.expiresAt > timestamp) return cached.result;
+    const pending = inFlight.get(packageName);
+    if (pending !== undefined) return pending;
+    const request = fetchNpmPackageStatistics(packageName, fetcher, timeoutMs);
+    inFlight.set(packageName, request);
+    try {
+      const result = await request;
+      cache.set(packageName, { expiresAt: now() + (result.failed ? failureTtlMs : ttlMs), result });
+      return result;
+    } finally {
+      if (inFlight.get(packageName) === request) inFlight.delete(packageName);
+    }
+  };
+  return async (plugins: readonly MarketplacePlugin[]): Promise<ReadonlyMap<string, MarketplaceStatistics>> => {
+    const packageNames = [...new Set(plugins.map((plugin) => marketplaceNpmPackageName(plugin.packageName)))].sort();
+    const entries = await Promise.all(packageNames.map(async (packageName) => [packageName, await loadPackage(packageName)] as const));
+    return new Map(entries.flatMap(([packageName, result]) => (result.statistics === undefined ? [] : [[packageName, result.statistics] as const])));
+  };
+}
+
+export function attachMarketplaceStatistics(
+  plugins: readonly MarketplacePlugin[],
+  statistics: ReadonlyMap<string, MarketplaceStatistics>,
+): readonly MarketplacePlugin[] {
+  return plugins.map((plugin) => {
+    const value = statistics.get(marketplaceNpmPackageName(plugin.packageName));
+    return value === undefined ? plugin : { ...plugin, statistics: value };
+  });
+}
+
+function marketplaceRecommendationScore(plugin: MarketplacePlugin, now: number): number {
+  const verified = plugin.status === "verified" ? 40 : 0;
+  const quality = (plugin.statistics?.quality ?? 0) * 30;
+  const downloads = Math.min(Math.log10((plugin.statistics?.downloads30d ?? 0) + 1) / 7, 1) * 20;
+  const updatedAt = plugin.statistics?.updatedAt === undefined ? undefined : Date.parse(plugin.statistics.updatedAt);
+  const ageDays = updatedAt === undefined || !Number.isFinite(updatedAt) ? Number.POSITIVE_INFINITY : Math.max(0, now - updatedAt) / 86_400_000;
+  const recency = Math.max(0, 1 - ageDays / 365) * 10;
+  return verified + quality + downloads + recency;
+}
+
+export function sortMarketplaceByRecommendation(plugins: readonly MarketplacePlugin[], now = Date.now()): readonly MarketplacePlugin[] {
+  return [...plugins].sort((left, right) => marketplaceRecommendationScore(right, now) - marketplaceRecommendationScore(left, now));
+}
+
+export function searchMarketplace(query = "", capability = "", category = ""): readonly MarketplacePlugin[] {
   const normalizedQuery = query.trim().toLowerCase();
   const normalizedCapability = capability.trim().toLowerCase();
+  const normalizedCategory = category.trim().toLowerCase();
   return MARKETPLACE_PLUGINS.filter((plugin) => {
     const searchable = [plugin.name, plugin.packageName, plugin.description, plugin.author, ...plugin.capabilities, ...plugin.hooks].join(" ").toLowerCase();
-    return (normalizedQuery === "" || searchable.includes(normalizedQuery))
-      && (normalizedCapability === "" || plugin.capabilities.some((item) => item.toLowerCase() === normalizedCapability));
+    return (
+      (normalizedQuery === "" || searchable.includes(normalizedQuery)) &&
+      (normalizedCapability === "" || plugin.capabilities.some((item) => item.toLowerCase() === normalizedCapability)) &&
+      (normalizedCategory === "" || plugin.category.id.toLowerCase() === normalizedCategory)
+    );
   });
 }
 
+export function paginateMarketplace(items: readonly MarketplacePlugin[], page = 0, pageSize = 24): MarketplacePage {
+  const normalizedPageSize = Math.min(Math.max(Math.trunc(pageSize) || 24, 1), 100);
+  const normalizedPage = Math.max(Math.trunc(page) || 0, 0);
+  const start = normalizedPage * normalizedPageSize;
+  return {
+    items: items.slice(start, start + normalizedPageSize),
+    total: items.length,
+    page: normalizedPage,
+    pageSize: normalizedPageSize,
+    hasNext: start + normalizedPageSize < items.length,
+  };
+}
+
 export const MARKETPLACE_CAPABILITIES = [...new Set(MARKETPLACE_PLUGINS.flatMap((plugin) => plugin.capabilities))].sort();
+export const MARKETPLACE_CATEGORIES: readonly MarketplaceCategory[] = [
+  ...new Map(MARKETPLACE_PLUGINS.map((plugin) => [plugin.category.id, { id: plugin.category.id, label: plugin.category.label, count: 0 }])).values(),
+]
+  .map((category) => ({ ...category, count: MARKETPLACE_PLUGINS.filter((plugin) => plugin.category.id === category.id).length }))
+  .sort((a, b) => a.label.localeCompare(b.label));

package/packages/api-gateway/src/workspaces.ts

@@ -0,0 +1,20 @@
+import { basename, resolve } from "node:path";
+
+export interface WorkspaceSummary {
+  readonly path: string;
+  readonly branch: string;
+  readonly current: boolean;
+  readonly name: string;
+}
+
+export function parseGitWorktrees(output: string, cwd: string): readonly WorkspaceSummary[] {
+  const items: WorkspaceSummary[] = [];
+  for (const block of output.trim().split(/\n\s*\n/)) {
+    const path = block.match(/^worktree (.+)$/m)?.[1]?.trim();
+    if (!path) continue;
+    const branch = block.match(/^branch refs\/heads\/(.+)$/m)?.[1]?.trim() ?? "detached";
+    const resolvedPath = resolve(path);
+    items.push({ path: resolvedPath, branch, current: resolvedPath === resolve(cwd), name: basename(resolvedPath) || resolvedPath });
+  }
+  return items;
+}