Import vendor/dsh-brain/lib/clients.js
This commit is contained in:
parent
5cd3e77c1f
commit
e35dc2a160
|
|
@ -0,0 +1,301 @@
|
|||
/**
|
||||
* Cross-software / workspace skill inventory (v1.1 §15).
|
||||
*
|
||||
* One adapter per client. It only reads directories the client itself publishes
|
||||
* (user-level skill roots and, when a workspace is known, that workspace's own
|
||||
* client folder). Nothing here writes another client's directory: DSH is the
|
||||
* only writable adapter in this build, and every other source is reported as
|
||||
* read-only instead of pretending a toggle works.
|
||||
*
|
||||
* Workspaces come from two bounded sources:
|
||||
* - the DSH workspace-group registry the host already keeps (member paths);
|
||||
* - directories the user explicitly adds here (persisted metadata only).
|
||||
* No full-disk scan, no chat history, no credential read.
|
||||
*/
|
||||
import { existsSync } from 'node:fs';
|
||||
import { readFile, readdir, stat } from 'node:fs/promises';
|
||||
import { homedir } from 'node:os';
|
||||
import { join, resolve, sep } from 'node:path';
|
||||
import { dshHome, migrateLegacyFile } from "./store.js";
|
||||
import { parseSkillFrontmatter } from "./skill-sync.js";
|
||||
import { SkillAdmin } from "./skill-admin.js";
|
||||
/** Manual workspace additions live in the plugin's own metadata file. */
|
||||
export function manualWorkspacesPath() {
|
||||
const target = join(dshHome(), 'dsh-brain-workspaces.json');
|
||||
migrateLegacyFile(target, join(dshHome(), 'cloud-memory-workspaces.json'));
|
||||
return target;
|
||||
}
|
||||
function rootsOf(home) {
|
||||
return {
|
||||
dsh: { configRoot: dshHome(), globalSkillsRoot: join(dshHome(), 'skills'), workspaceSubdirs: [join('.dsh', 'skills')] },
|
||||
agents: { configRoot: join(home, '.agents'), globalSkillsRoot: join(home, '.agents', 'skills'), workspaceSubdirs: [] },
|
||||
codex: { configRoot: join(home, '.codex'), globalSkillsRoot: join(home, '.codex', 'skills'), workspaceSubdirs: [join('.codex', 'skills')] },
|
||||
workbuddy: { configRoot: join(home, '.workbuddy'), globalSkillsRoot: join(home, '.workbuddy', 'skills'), workspaceSubdirs: [] },
|
||||
claude: { configRoot: join(home, '.claude'), globalSkillsRoot: join(home, '.claude', 'skills'), workspaceSubdirs: [join('.claude', 'skills')] },
|
||||
opencode: { configRoot: join(home, '.config', 'opencode'), globalSkillsRoot: join(home, '.config', 'opencode', 'skills'), workspaceSubdirs: [join('.opencode', 'skills'), join('.opencode', 'skill')] },
|
||||
};
|
||||
}
|
||||
const LABELS = {
|
||||
dsh: 'DSH',
|
||||
agents: '公共 Agent',
|
||||
codex: 'Codex',
|
||||
workbuddy: 'WorkBuddy',
|
||||
claude: 'Claude Code',
|
||||
opencode: 'OpenCode',
|
||||
};
|
||||
const SOFTWARE = ['dsh', 'agents', 'codex', 'workbuddy', 'claude', 'opencode'];
|
||||
export class ClientRegistry {
|
||||
deps;
|
||||
constructor(deps = {}) {
|
||||
this.deps = deps;
|
||||
}
|
||||
home() {
|
||||
return this.deps.home?.() ?? homedir();
|
||||
}
|
||||
roots() {
|
||||
return rootsOf(this.home());
|
||||
}
|
||||
adapters() {
|
||||
const roots = this.roots();
|
||||
return SOFTWARE.map((id) => {
|
||||
const root = roots[id];
|
||||
const installed = existsSync(root.configRoot);
|
||||
const notes = [];
|
||||
if (!installed)
|
||||
notes.push('未检测到安装目录');
|
||||
const writable = id === 'dsh';
|
||||
if (!writable)
|
||||
notes.push('本卡只读,不修改该软件的技能目录');
|
||||
return {
|
||||
id,
|
||||
label: LABELS[id],
|
||||
installed,
|
||||
configRoot: root.configRoot,
|
||||
globalSkillsRoot: root.globalSkillsRoot,
|
||||
writable,
|
||||
workspaceSupported: root.workspaceSubdirs.length > 0,
|
||||
notes,
|
||||
};
|
||||
});
|
||||
}
|
||||
capabilities() {
|
||||
return this.adapters().map((adapter) => ({
|
||||
id: adapter.id,
|
||||
label: adapter.label,
|
||||
readGlobal: true,
|
||||
writeGlobal: adapter.writable,
|
||||
workspaceRead: adapter.workspaceSupported,
|
||||
// Workspace-level writes are implemented for DSH only; every other client
|
||||
// stays read-only so nothing is written into a format we cannot verify.
|
||||
workspaceWrite: adapter.id === 'dsh' && adapter.workspaceSupported,
|
||||
hotReload: adapter.id === 'dsh',
|
||||
verify: true,
|
||||
notes: adapter.notes,
|
||||
}));
|
||||
}
|
||||
/**
|
||||
* A workspace-scoped SkillAdmin for the DSH adapter. The skills root is the
|
||||
* workspace's own `.dsh/skills`; parked skills go to a per-workspace holding
|
||||
* area so one project can never unpark another's skill. Only DSH is allowed.
|
||||
*/
|
||||
async workspaceSkillAdmin(softwareInput, workspaceIdInput) {
|
||||
const software = SOFTWARE.includes(softwareInput) ? softwareInput : undefined;
|
||||
if (software !== 'dsh')
|
||||
throw new Error('unsupported_workspace_write');
|
||||
const workspaceId = typeof workspaceIdInput === 'string' ? workspaceIdInput : '';
|
||||
const workspace = (await this.workspaces('dsh')).find((item) => item.id === workspaceId);
|
||||
if (workspace === undefined)
|
||||
throw new Error('unknown_workspace');
|
||||
const skillsRoot = resolve(workspace.path, '.dsh', 'skills');
|
||||
const holdingDir = join(dshHome(), 'skills-workspace-disabled', workspace.id);
|
||||
const stateName = `${workspace.id.replace(/[^A-Za-z0-9_-]/g, '_')}.json`;
|
||||
const statePath = join(dshHome(), `dsh-brain-workspace-${stateName}`);
|
||||
migrateLegacyFile(statePath, join(dshHome(), `cloud-memory-workspace-${stateName}`));
|
||||
const admin = new SkillAdmin({
|
||||
skillsRoot: () => skillsRoot,
|
||||
holdingDir: () => holdingDir,
|
||||
syncStatePath: () => statePath,
|
||||
syncRunning: () => false,
|
||||
log: () => { },
|
||||
});
|
||||
return { admin, workspace };
|
||||
}
|
||||
async readManual() {
|
||||
const path = this.deps.manualPath?.() ?? manualWorkspacesPath();
|
||||
try {
|
||||
const parsed = JSON.parse(await readFile(path, 'utf8'));
|
||||
if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
|
||||
const raw = parsed;
|
||||
const items = Array.isArray(raw.items)
|
||||
? raw.items.filter((item) => (item !== null && typeof item === 'object'
|
||||
&& typeof item.softwareId === 'string'
|
||||
&& typeof item.path === 'string'))
|
||||
: [];
|
||||
return { version: 1, items };
|
||||
}
|
||||
}
|
||||
catch {
|
||||
// Missing sidecar: no manual workspaces yet.
|
||||
}
|
||||
return { version: 1, items: [] };
|
||||
}
|
||||
async writeManual(file) {
|
||||
const path = this.deps.manualPath?.() ?? manualWorkspacesPath();
|
||||
const { mkdir, writeFile } = await import('node:fs/promises');
|
||||
await mkdir(join(path, '..'), { recursive: true });
|
||||
await writeFile(path, `${JSON.stringify(file, null, 2)}\n`, 'utf8');
|
||||
}
|
||||
/** DSH workspaces come from the host's own workspace-group registry. */
|
||||
async dshRegistryWorkspaces() {
|
||||
const path = this.deps.dshRegistryPath?.() ?? join(dshHome(), 'workspace-groups.folders.json');
|
||||
const categoriesPath = this.deps.dshManualPath?.() ?? join(dshHome(), 'workspace-groups.manual.json');
|
||||
let categories = new Map();
|
||||
try {
|
||||
const raw = JSON.parse(await readFile(categoriesPath, 'utf8'));
|
||||
if (raw.assignments !== null && typeof raw.assignments === 'object') {
|
||||
categories = new Map(Object.entries(raw.assignments));
|
||||
}
|
||||
}
|
||||
catch {
|
||||
// No category mapping: names fall back to the folder name.
|
||||
}
|
||||
try {
|
||||
const raw = JSON.parse(await readFile(path, 'utf8'));
|
||||
const out = [];
|
||||
const seen = new Set();
|
||||
for (const [groupId, group] of Object.entries(raw.workspaces ?? {})) {
|
||||
for (const member of group.members ?? []) {
|
||||
if (typeof member.path !== 'string' || member.path === '' || seen.has(member.path))
|
||||
continue;
|
||||
seen.add(member.path);
|
||||
const id = typeof member.workspaceId === 'string' && member.workspaceId !== '' ? member.workspaceId : groupId;
|
||||
const parts = member.path.split(/[\\/]/).filter((part) => part !== '');
|
||||
const category = categories.get(id);
|
||||
out.push({ id, name: parts[parts.length - 1] ?? member.path, path: member.path, source: 'dsh-registry', ...(category === undefined ? {} : { category }) });
|
||||
}
|
||||
}
|
||||
return out;
|
||||
}
|
||||
catch {
|
||||
return [];
|
||||
}
|
||||
}
|
||||
async workspaces(software) {
|
||||
const manual = (await this.readManual()).items.filter((item) => item.softwareId === software);
|
||||
const fromManual = manual.map((item) => ({ id: item.id, name: item.name, path: item.path, source: 'manual' }));
|
||||
if (software === 'dsh') {
|
||||
const registry = await this.dshRegistryWorkspaces();
|
||||
const byPath = new Set(registry.map((item) => item.path));
|
||||
return [...registry, ...fromManual.filter((item) => !byPath.has(item.path))];
|
||||
}
|
||||
return fromManual;
|
||||
}
|
||||
async addWorkspace(softwareInput, pathInput, nameInput) {
|
||||
const software = SOFTWARE.includes(softwareInput) ? softwareInput : undefined;
|
||||
if (software === undefined)
|
||||
throw new Error('invalid_software');
|
||||
const path = typeof pathInput === 'string' ? pathInput.trim() : '';
|
||||
if (path === '' || !existsSync(path))
|
||||
throw new Error('invalid_path');
|
||||
const stats = await stat(path).catch(() => undefined);
|
||||
if (stats === undefined || !stats.isDirectory())
|
||||
throw new Error('invalid_path');
|
||||
const resolved = resolve(path);
|
||||
const file = await this.readManual();
|
||||
if (file.items.some((item) => item.softwareId === software && resolve(item.path) === resolved))
|
||||
throw new Error('duplicate');
|
||||
const name = typeof nameInput === 'string' && nameInput.trim() !== '' ? nameInput.trim() : resolved.split(sep).filter((part) => part !== '').pop() ?? resolved;
|
||||
const record = { id: `ws_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`, name, path: resolved, source: 'manual' };
|
||||
file.items.push({ softwareId: software, id: record.id, name: record.name, path: record.path });
|
||||
await this.writeManual(file);
|
||||
return record;
|
||||
}
|
||||
async removeWorkspace(softwareInput, idInput) {
|
||||
const software = SOFTWARE.includes(softwareInput) ? softwareInput : undefined;
|
||||
const id = typeof idInput === 'string' ? idInput : '';
|
||||
const file = await this.readManual();
|
||||
const before = file.items.length;
|
||||
file.items = file.items.filter((item) => !(item.softwareId === software && item.id === id));
|
||||
if (file.items.length === before)
|
||||
throw new Error('not_found');
|
||||
await this.writeManual(file);
|
||||
return { removed: id };
|
||||
}
|
||||
async inventoryOf(dir, software, scope, workspaceId) {
|
||||
const out = [];
|
||||
// DSH global and DSH workspace roots are writable by this build; every
|
||||
// other client (and every non-DSH workspace) is read-only.
|
||||
const writable = software === 'dsh';
|
||||
for (const entry of await readdir(dir, { withFileTypes: true }).catch(() => [])) {
|
||||
if (!entry.isDirectory() || entry.name.startsWith('.'))
|
||||
continue;
|
||||
const skillDir = join(dir, entry.name);
|
||||
const markdown = await readFile(join(skillDir, 'SKILL.md'), 'utf8').catch(() => undefined);
|
||||
if (markdown === undefined)
|
||||
continue;
|
||||
const frontmatter = parseSkillFrontmatter(markdown);
|
||||
out.push({
|
||||
folder: entry.name,
|
||||
name: typeof frontmatter.name === 'string' && frontmatter.name !== '' ? frontmatter.name : entry.name,
|
||||
description: String(frontmatter.description ?? '').slice(0, 300),
|
||||
path: skillDir,
|
||||
softwareId: software,
|
||||
scope,
|
||||
...(workspaceId === undefined ? {} : { workspaceId }),
|
||||
writable,
|
||||
});
|
||||
}
|
||||
out.sort((a, b) => (a.folder < b.folder ? -1 : 1));
|
||||
return out;
|
||||
}
|
||||
async inventory(softwareInput, scopeInput, workspaceIdInput) {
|
||||
const software = SOFTWARE.includes(softwareInput) ? softwareInput : undefined;
|
||||
if (software === undefined)
|
||||
throw new Error('invalid_software');
|
||||
const scope = scopeInput === 'workspace' ? 'workspace' : 'global';
|
||||
const roots = this.roots()[software];
|
||||
if (scope === 'global') {
|
||||
return { softwareId: software, scope, items: await this.inventoryOf(roots.globalSkillsRoot, software, 'global'), note: software === 'dsh' ? 'DSH 全局技能目录。' : '该软件的用户级技能目录,本卡只读。' };
|
||||
}
|
||||
const workspaceId = typeof workspaceIdInput === 'string' ? workspaceIdInput : '';
|
||||
const workspace = (await this.workspaces(software)).find((item) => item.id === workspaceId);
|
||||
if (workspace === undefined)
|
||||
throw new Error('unknown_workspace');
|
||||
// DSH workspace skills are enumerated through a workspace-scoped SkillAdmin
|
||||
// so the list, the enabled flag and the inventory agree with the write path.
|
||||
if (software === 'dsh') {
|
||||
const { admin } = await this.workspaceSkillAdmin('dsh', workspace.id);
|
||||
const listed = await admin.list();
|
||||
const items = listed.skills.map((skill) => ({
|
||||
folder: skill.folder,
|
||||
name: skill.name,
|
||||
description: skill.description,
|
||||
path: join(skill.enabled ? listed.root : listed.holding, skill.folder),
|
||||
softwareId: 'dsh',
|
||||
scope: 'workspace',
|
||||
workspaceId: workspace.id,
|
||||
writable: true,
|
||||
enabled: skill.enabled,
|
||||
}));
|
||||
return { softwareId: 'dsh', scope, workspace, items, note: `DSH 工作区技能目录:${join(workspace.path, '.dsh', 'skills')}` };
|
||||
}
|
||||
for (const sub of roots.workspaceSubdirs) {
|
||||
const dir = resolve(workspace.path, sub);
|
||||
if (existsSync(dir)) {
|
||||
return { softwareId: software, scope, workspace, items: await this.inventoryOf(dir, software, 'workspace', workspace.id), note: `工作区专属目录:${dir}` };
|
||||
}
|
||||
}
|
||||
return { softwareId: software, scope, workspace, items: [], note: `该工作区没有 ${LABELS[software]} 的专属技能目录;不会写通用配置替代。` };
|
||||
}
|
||||
async overview() {
|
||||
const workspaces = {};
|
||||
for (const id of SOFTWARE)
|
||||
workspaces[id] = await this.workspaces(id);
|
||||
return {
|
||||
adapters: this.adapters(),
|
||||
capabilities: this.capabilities(),
|
||||
workspaces,
|
||||
brain: { product: 'DSH Brain', targetPackage: 'dsh-brain', legacyPackage: 'dsh-cloud-memory' },
|
||||
};
|
||||
}
|
||||
}
|
||||
Loading…
Reference in New Issue