@stofone/dsh-agent-roster 0.12.0 → 0.13.0

package/index.js

@@ -174,8 +174,107 @@ export function apply(ctx, config) {
       "collection route",
     );
 
-    // 搜索是「找一份档案」的入口：一次请求横跨本机与所有订阅来源。
-    // 远端的拉取复用 collection 的 60s 缓存，所以连续输入不会对同一个集合重复打网络。
+    // 「档案库」与「搜索」共用同一次摊平动作：本机 + 所有订阅来源。
+    // 两条路由各写一遍，缓存口径、并发上限与诊断文案迟早会分叉。
+    const gatherEntries = async ({ refresh = false } = {}) => {
+      const library = collectLibrary(ctx, settings, { name: pkg.name, version: pkg.version });
+      const entries = [];
+      let localCount = 0;
+      for (const workspace of library.workspaces) {
+        for (const roster of workspace.rosters) {
+          entries.push({ scope: "local", roster, libraryId: workspace.rootDir ?? null, file: roster.file ?? null });
+          localCount += 1;
+        }
+      }
+
+      const diagnostics = [];
+      const collections = [];
+      try {
+        const remote = await loadRemotePanel(settings, { refresh });
+        for (const item of remote.diagnostics ?? []) if (item.severity !== "info") diagnostics.push(item);
+        for (const collection of remote.collections ?? []) collections.push(collection);
+      } catch (error) {
+        diagnostics.push({
+          severity: "warn",
+          code: "index-unavailable",
+          message: `订阅索引拉不到，这次只显示本机档案：${error instanceof Error ? error.message : String(error)}`,
+        });
+      }
+
+      // 来源两两并发：一个慢集合不该把所有来源都拖住，也不该一次打三十个请求。
+      const sourceConcurrency = 2;
+      let cursor = 0;
+      const fetchNext = async () => {
+        while (cursor < collections.length) {
+          const collection = collections[cursor];
+          cursor += 1;
+          const key = `${collection.source ?? ""}::${collection.id}`;
+          try {
+            const cached = collectionCache.get(key);
+            const fetched = cached ?? collectionCache.set(key, await fetchCollection(collection));
+            for (const roster of fetched.rosters ?? []) {
+              entries.push({
+                scope: "remote",
+                roster,
+                collectionId: collection.id,
+                collectionTitle: collection.title ?? null,
+                file: roster.file ?? null,
+              });
+            }
+            for (const item of fetched.diagnostics ?? []) if (item.severity === "error") diagnostics.push(item);
+          } catch (error) {
+            diagnostics.push({
+              severity: "warn",
+              code: "source-failed",
+              message: `${collection.id} 拉取失败：${error instanceof Error ? error.message : String(error)}`,
+            });
+          }
+        }
+      };
+      await Promise.all(Array.from({ length: Math.min(sourceConcurrency, collections.length) }, fetchNext));
+
+      return { entries, diagnostics: diagnostics.slice(0, 20), counts: { local: localCount, remote: entries.length - localCount } };
+    };
+
+    const catalogEntry = (entry) => {
+      const roster = entry.roster;
+      return {
+        scope: entry.scope,
+        rosterId: typeof roster.id === "string" ? roster.id : "",
+        title: typeof roster.title === "string" ? roster.title : "",
+        description: typeof roster.description === "string" ? roster.description : "",
+        tags: Array.isArray(roster.tags) ? roster.tags : [],
+        members: Array.isArray(roster.members) ? roster.members.length : 0,
+        memberRoles: (Array.isArray(roster.members) ? roster.members : [])
+          .map((member) => (typeof member?.role === "string" ? member.role : ""))
+          .filter((role) => role !== "")
+          .slice(0, 4),
+        libraryId: entry.libraryId ?? null,
+        collectionId: entry.collectionId ?? null,
+        collectionTitle: entry.collectionTitle ?? null,
+        file: entry.file ?? null,
+      };
+    };
+
+    // 档案库：像插件市场那样「全部摊开」，供浏览、按标签筛选、按来源聚合。
+    register(
+      "/plugins/dsh-agent-roster/catalog",
+      async (req, res) => {
+        if (guard(req, res)) return;
+        if (!requireMethod(req, res, "GET")) return;
+        const query = new URL(req.url ?? "/", "http://localhost").searchParams;
+        const gathered = await gatherEntries({ refresh: query.get("refresh") === "1" });
+        sendJson(res, 200, {
+          ok: true,
+          entries: gathered.entries.map(catalogEntry),
+          counts: gathered.counts,
+          diagnostics: gathered.diagnostics,
+        });
+      },
+      "catalog route",
+    );
+
+    // 搜索：同一个「摊平」结果上做排序，回车即可打开。空查询不做无谓的摊平。
     register(
       "/plugins/dsh-agent-roster/search",
       async (req, res) => {
@@ -187,70 +286,9 @@ export function apply(ctx, config) {
           sendJson(res, 200, { ok: true, q: "", tokens: [], total: 0, matches: [], counts: { local: 0, remote: 0 }, diagnostics: [] });
           return;
         }
-
-        const library = collectLibrary(ctx, settings, { name: pkg.name, version: pkg.version });
-        const entries = [];
-        let localCount = 0;
-        for (const workspace of library.workspaces) {
-          for (const roster of workspace.rosters) {
-            entries.push({ scope: "local", roster, libraryId: workspace.rootDir ?? null, file: roster.file ?? null });
-            localCount += 1;
-          }
-        }
-
-        const diagnostics = [];
-        const collections = [];
-        try {
-          const remote = await loadRemotePanel(settings, {});
-          for (const item of remote.diagnostics ?? []) if (item.severity !== "info") diagnostics.push(item);
-          for (const collection of remote.collections ?? []) collections.push(collection);
-        } catch (error) {
-          diagnostics.push({
-            severity: "warn",
-            code: "search-index-unavailable",
-            message: `订阅索引拉不到，本次只搜索本机档案：${error instanceof Error ? error.message : String(error)}`,
-          });
-        }
-
-        // 来源两两并发：一个慢集合不该把所有来源都拖住，也不该一次打三十个请求。
-        const sourceConcurrency = 2;
-        let cursor = 0;
-        const fetchNext = async () => {
-          while (cursor < collections.length) {
-            const collection = collections[cursor];
-            cursor += 1;
-            const key = `${collection.source ?? ""}::${collection.id}`;
-            try {
-              const cached = collectionCache.get(key);
-              const fetched = cached ?? collectionCache.set(key, await fetchCollection(collection));
-              for (const roster of fetched.rosters ?? []) {
-                entries.push({
-                  scope: "remote",
-                  roster,
-                  collectionId: collection.id,
-                  collectionTitle: collection.title ?? null,
-                  file: roster.file ?? null,
-                });
-              }
-              for (const item of fetched.diagnostics ?? []) if (item.severity === "error") diagnostics.push(item);
-            } catch (error) {
-              diagnostics.push({
-                severity: "warn",
-                code: "search-source-failed",
-                message: `${collection.id} 拉取失败：${error instanceof Error ? error.message : String(error)}`,
-              });
-            }
-          }
-        };
-        await Promise.all(Array.from({ length: Math.min(sourceConcurrency, collections.length) }, fetchNext));
-
-        const result = searchRosters(q, entries);
-        const remoteCount = entries.length - localCount;
-        sendJson(res, 200, {
-          ...result,
-          counts: { local: localCount, remote: remoteCount },
-          diagnostics: diagnostics.slice(0, 20),
-        });
+        const gathered = await gatherEntries();
+        const result = searchRosters(q, gathered.entries);
+        sendJson(res, 200, { ...result, counts: gathered.counts, diagnostics: gathered.diagnostics });
       },
       "search route",
     );

package/lib/compile2.js

@@ -231,7 +231,13 @@ export function compileRoster(options) {
     source: {
       roster: roster.id,
       version: roster.version,
+      // 产物是唯一被分发的形态：发现它所需的一切（标题、标签、许可、维护者）必须自带，
+      // 否则"从远处找一份档案"就只剩一个 id。
       title: roster.title ?? null,
+      description: roster.description ?? null,
+      tags: Array.isArray(roster.tags) ? roster.tags : [],
+      license: roster.license ?? null,
+      maintainers: Array.isArray(roster.maintainers) ? roster.maintainers : [],
       repo: options.source?.repo ?? null,
       ref: options.source?.ref ?? null,
       lock: options.source?.lock ?? null,
@@ -510,10 +516,10 @@ export function rosterViewOf(compiled, roster2, options = {}) {
     version: compiled.source.version,
     file: compiled.source.file ?? null,
     title: roster2?.title ?? compiled.source.title ?? "",
-    description: roster2?.description ?? "",
-    license: roster2?.license ?? "",
-    maintainers: roster2?.maintainers ?? [],
-    tags: roster2?.tags ?? [],
+    description: roster2?.description ?? compiled.source.description ?? "",
+    license: roster2?.license ?? compiled.source.license ?? "",
+    maintainers: roster2?.maintainers ?? compiled.source.maintainers ?? [],
+    tags: roster2?.tags ?? compiled.source.tags ?? [],
     notes: roster2?.notes ?? null,
     members,
     captain,
@@ -618,6 +624,9 @@ export function flattenCompiledToRoster(compiled) {
   };
   if (source.title) roster.title = source.title;
   if (source.description) roster.description = source.description;
+  if (source.license) roster.license = source.license;
+  if (Array.isArray(source.maintainers) && source.maintainers.length > 0) roster.maintainers = source.maintainers;
+  if (Array.isArray(source.tags) && source.tags.length > 0) roster.tags = source.tags;
   if (compiled.captain) {
     const captain = { name: String(compiled.captain.role ?? "").replace(/@[^@]*$/, "") };
     if (compiled.captain.provider) captain.provider = compiled.captain.provider;

package/locale/en.json

@@ -64,7 +64,8 @@
     "metaRosters": "rosters",
     "metaMembers": "members",
     "metaTeams": "teams",
-    "metaOrganization": "Organization {name}"
+    "metaOrganization": "Organization {name}",
+    "tabsCatalog": "Library"
   },
   "roster": {
     "members": "{count} members",
@@ -302,18 +303,20 @@
   "source.filter": "Filter this collection",
   "source.filterPlaceholder": "Filter by id, title or member",
   "source.filterCount": "{shown} of {total}",
-  "lookup": {
+  "catalog": {
     "placeholder": "What should it do? e.g. data quality, release, review",
-    "hint": "Searches this machine and every subscribed source",
-    "clear": "Clear",
     "searching": "Searching…",
-    "counts": "{total} matched · candidates: {local} local · {remote} remote",
-    "empty": "Nothing matched “{q}”. Try another wording, or check Sources for a subscription that has it.",
-    "failed": "Search failed: the host did not answer.",
+    "counts": "{shown} / {total} · {local} local · {remote} remote",
+    "empty": "Nothing matches. Try another wording, or check Sources for a subscription.",
+    "failed": "The library did not load: the host did not answer.",
     "members": "{count} members",
     "local": "local",
     "remoteFrom": "from {collection}",
     "open": "Open",
-    "pull": "Pull"
+    "pull": "Pull",
+    "mode": "Layout",
+    "modeSource": "By source",
+    "modeFlat": "Flat",
+    "refresh": "Refresh"
   }
 }

package/locale/zh.json

@@ -64,7 +64,8 @@
     "metaRosters": "份档案",
     "metaMembers": "名成员",
     "metaTeams": "支团队",
-    "metaOrganization": "组织 {name}"
+    "metaOrganization": "组织 {name}",
+    "tabsCatalog": "档案库"
   },
   "roster": {
     "members": "{count} 名成员",
@@ -302,18 +303,20 @@
   "source.filter": "在这份集合里查找",
   "source.filterPlaceholder": "按 id、标题或成员名过滤",
   "source.filterCount": "{shown} / {total}",
-  "lookup": {
+  "catalog": {
     "placeholder": "要找什么能力？例：数据质量、发版、代码评审",
-    "hint": "同时搜本机与已订阅的来源",
-    "clear": "清除",
     "searching": "正在搜索…",
-    "counts": "命中 {total} 份 · 候选：本机 {local} · 远端 {remote}",
-    "empty": "没有找到「{q}」。换个说法，或到「档案源」看看是否订阅了它。",
-    "failed": "搜索失败：宿主没有响应。",
+    "counts": "{shown} / {total} 份 · 本机 {local} · 远端 {remote}",
+    "empty": "没有符合条件的档案。换个词，或去「档案源」看看订阅。",
+    "failed": "档案库加载失败：宿主没有响应。",
     "members": "{count} 名成员",
     "local": "本机",
     "remoteFrom": "来自 {collection}",
     "open": "打开",
-    "pull": "拉取"
+    "pull": "拉取",
+    "mode": "显示方式",
+    "modeSource": "按来源",
+    "modeFlat": "平铺",
+    "refresh": "刷新"
   }
 }

package/orgs/agent-roster-collective/dist/api-design-1.0.0.json

@@ -4,6 +4,16 @@
     "roster": "api-design",
     "version": "1.0.0",
     "title": "API 设计评审组",
+    "description": "在写第一行实现之前，把接口的形状、演进与失败语义定下来。",
+    "tags": [
+      "api",
+      "design",
+      "review"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/content-ops-1.0.0.json

@@ -4,6 +4,15 @@
     "roster": "content-ops",
     "version": "1.0.0",
     "title": "内容运营组",
+    "description": "一次发布：选题、成稿、分发，三件事各有验收。",
+    "tags": [
+      "content",
+      "publishing"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/contract-review-1.0.0.json

@@ -4,6 +4,15 @@
     "roster": "contract-review",
     "version": "1.0.0",
     "title": "合同审阅组",
+    "description": "找到会让你赔钱、被锁定或无法退出的条款。",
+    "tags": [
+      "legal",
+      "contract"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/data-quality-1.0.0.json

@@ -4,6 +4,16 @@
     "roster": "data-quality",
     "version": "1.0.0",
     "title": "数据质量组",
+    "description": "为一份数据表定“什么算合格”，并把不合格变成可复现的判据。",
+    "tags": [
+      "data",
+      "quality",
+      "checks"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/db-migration-1.0.0.json

@@ -4,6 +4,16 @@
     "roster": "db-migration",
     "version": "1.0.0",
     "title": "数据库迁移组",
+    "description": "把一次 schema 变更做到可回滚：先证明能回，再动手。",
+    "tags": [
+      "database",
+      "migration",
+      "reliability"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/docs-writer-1.0.0.json

@@ -4,6 +4,15 @@
     "roster": "docs-writer",
     "version": "1.0.0",
     "title": "文档组",
+    "description": "让文档里的每条命令都真的能跑，每个读数都带时间。",
+    "tags": [
+      "docs",
+      "writing"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/finance-recon-1.0.0.json

@@ -4,6 +4,15 @@
     "roster": "finance-recon",
     "version": "1.0.0",
     "title": "财务对账组",
+    "description": "让两套账的差异落到具体行，而不是“大概对得上”。",
+    "tags": [
+      "finance",
+      "reconciliation"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/frontend-ui-1.0.0.json

@@ -4,6 +4,16 @@
     "roster": "frontend-ui",
     "version": "1.0.0",
     "title": "前端实现组",
+    "description": "把设计做成能用、能读、能被键盘与读屏器操作的东西。",
+    "tags": [
+      "frontend",
+      "ui",
+      "a11y"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/i18n-l10n-1.0.0.json

@@ -4,6 +4,16 @@
     "roster": "i18n-l10n",
     "version": "1.0.0",
     "title": "本地化组",
+    "description": "把一份文案做成两种语言，且两种语言说同一件事。",
+    "tags": [
+      "i18n",
+      "docs",
+      "review"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/incident-response-1.0.0.json

@@ -4,6 +4,16 @@
     "roster": "incident-response",
     "version": "1.0.0",
     "title": "事故响应组",
+    "description": "线上出事时的三个人：指挥、定位、记录；先止损再找根因。",
+    "tags": [
+      "incident",
+      "oncall",
+      "reliability"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/literature-review-1.0.0.json

@@ -4,6 +4,15 @@
     "roster": "literature-review",
     "version": "1.0.0",
     "title": "文献综述组",
+    "description": "把一堆论文读成一张能追到出处的证据表。",
+    "tags": [
+      "research",
+      "literature"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/market-research-1.0.0.json

@@ -4,6 +4,15 @@
     "roster": "market-research",
     "version": "1.0.0",
     "title": "市场研究组",
+    "description": "把“听说”变成“有出处的数”，并说清它什么时候会失效。",
+    "tags": [
+      "research",
+      "market"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/ml-eval-1.0.0.json

@@ -4,6 +4,15 @@
     "roster": "ml-eval",
     "version": "1.0.0",
     "title": "模型评测组",
+    "description": "跑分之前先问：这套题能不能区分好坏。",
+    "tags": [
+      "ml",
+      "evaluation"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/performance-1.0.0.json

@@ -4,6 +4,15 @@
     "roster": "performance",
     "version": "1.0.0",
     "title": "性能优化组",
+    "description": "先量再改：没有基线就没有优化。",
+    "tags": [
+      "performance",
+      "profiling"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/product-discovery-1.0.0.json

@@ -4,6 +4,15 @@
     "roster": "product-discovery",
     "version": "1.0.0",
     "title": "产品发现组",
+    "description": "在写需求之前，先证明这个需求真的存在。",
+    "tags": [
+      "product",
+      "discovery"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/qa-regression-1.0.0.json

@@ -4,6 +4,16 @@
     "roster": "qa-regression",
     "version": "1.0.0",
     "title": "回归测试组",
+    "description": "每次改动都问：哪些旧行为可能被碰坏。",
+    "tags": [
+      "qa",
+      "regression",
+      "testing"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/recruiting-1.0.0.json

@@ -4,6 +4,15 @@
     "roster": "recruiting",
     "version": "1.0.0",
     "title": "招聘筛选组",
+    "description": "按岗位要求筛人，只报证据，不做印象判断。",
+    "tags": [
+      "hiring",
+      "screening"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/release-manager-1.0.0.json

@@ -4,6 +4,15 @@
     "roster": "release-manager",
     "version": "1.0.0",
     "title": "发布管理组",
+    "description": "每一次发布都可复现、可回滚、可解释。",
+    "tags": [
+      "release",
+      "versioning"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/security-audit-1.0.0.json

@@ -4,6 +4,16 @@
     "roster": "security-audit",
     "version": "1.0.0",
     "title": "安全审计组",
+    "description": "在代码里找“能被利用”的东西，而不是“看着不安全”的东西。",
+    "tags": [
+      "security",
+      "audit",
+      "review"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/sre-oncall-1.0.0.json

@@ -4,6 +4,16 @@
     "roster": "sre-oncall",
     "version": "1.0.0",
     "title": "SRE 值守组",
+    "description": "值守不是盯屏：定告警阈值、写手册、算容量。",
+    "tags": [
+      "sre",
+      "oncall",
+      "capacity"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/orgs/agent-roster-collective/dist/support-triage-1.0.0.json

@@ -4,6 +4,15 @@
     "roster": "support-triage",
     "version": "1.0.0",
     "title": "客服分诊组",
+    "description": "把每条来信分到“能自助、要人接、是缺陷”三条路之一。",
+    "tags": [
+      "support",
+      "triage"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,