|
| 1 | +// bind 域：把 workflow 产物的 skills 按宿主适配器描述符绑入宿主 skills 发现目录（无 brief 域）。 |
| 2 | +// 描述符数据化：adapters/<host>.json 随产物分发，新增宿主 = 新增描述符，本域零改动。 |
| 3 | +// 托管标记走 sidecar（.shadow-dev-workflow.json），不改 SKILL.md 字节；非托管同名目录 guard 拒绝，绝不静默覆盖。 |
| 4 | +import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs' |
| 5 | +import { createHash } from 'node:crypto' |
| 6 | +import { homedir } from 'node:os' |
| 7 | +import { join } from 'node:path' |
| 8 | +import { err } from '../errors.mjs' |
| 9 | +import { plan } from '../plan.mjs' |
| 10 | +import { confirm } from '../input.mjs' |
| 11 | +import { resolvedRoot } from './workflow.mjs' |
| 12 | + |
| 13 | +const SIDECAR = '.shadow-dev-workflow.json' |
| 14 | +const home = () => process.env.SHADOW_WORKFLOW_HOME || homedir() |
| 15 | +// 描述符里 ~ 开头的 skillsDir 相对宿主 home 解析；SHADOW_WORKFLOW_HOME 供测试/隔离覆盖 |
| 16 | +const skillsDirOf = adapter => adapter.skillsDir.replace(/^~(?=\/|$)/, home()) |
| 17 | +const verOf = root => { try { return JSON.parse(readFileSync(join(root, 'package.json'), 'utf8')).version } catch { return null } } |
| 18 | + |
| 19 | +export function loadAdapters(root) { |
| 20 | + const dir = join(root, 'adapters') |
| 21 | + if (!existsSync(dir)) throw err('ADAPTERS_MISSING', 'ADAPTERS_MISSING: artifact lacks adapters/ (needs a workflow release that ships descriptors)', 1) |
| 22 | + return readdirSync(dir).filter(f => f.endsWith('.json')).map(f => JSON.parse(readFileSync(join(dir, f), 'utf8'))) |
| 23 | +} |
| 24 | + |
| 25 | +const sidecarRead = dir => { try { return JSON.parse(readFileSync(join(dir, SIDECAR), 'utf8')) } catch { return null } } |
| 26 | +const dirHash = d => createHash('sha256').update(readdirSync(d).sort().map(f => `${f}:${readFileSync(join(d, f), 'utf8')}`).join('\n')).digest('hex') |
| 27 | + |
| 28 | +export function planData(_r, o) { |
| 29 | + const root = resolvedRoot(o) |
| 30 | + const adapters = loadAdapters(root) |
| 31 | + let selected = o.host && o.host !== 'auto' ? adapters.filter(a => a.host === o.host) : adapters |
| 32 | + if (o.host && o.host !== 'auto' && !selected.length) throw err('HOST_NOT_FOUND', `HOST_NOT_FOUND: no adapter for host "${o.host}"`, 1) |
| 33 | + if (!o.host || o.host === 'auto') selected = selected.filter(a => existsSync(skillsDirOf(a))) |
| 34 | + if (!selected.length) throw err('HOST_NOT_FOUND', 'HOST_NOT_FOUND: no supported host detected on this machine (adapters exist, but no skillsDir present)', 1) |
| 35 | + const hosts = selected.map(a => { |
| 36 | + const dir = skillsDirOf(a) |
| 37 | + const sidecar = sidecarRead(dir) |
| 38 | + const entries = readdirSync(join(root, 'skills')).filter(s => existsSync(join(root, 'skills', s))).sort().map(skill => { |
| 39 | + const exists = existsSync(join(dir, skill)) |
| 40 | + const managed = !!(sidecar && sidecar.skills && sidecar.skills[skill]) |
| 41 | + return { skill, target: join(dir, skill), exists, managed, blocked: exists && !managed } |
| 42 | + }) |
| 43 | + return { host: a.host, tier: a.tier || null, skillsDir: dir, sidecar: !!sidecar, entries } |
| 44 | + }) |
| 45 | + return { action: 'bind', artifactRoot: root, version: verOf(root), hosts } |
| 46 | +} |
| 47 | + |
| 48 | +export function executeDomain(o) { |
| 49 | + confirm(o) |
| 50 | + const e = plan('bind', planData(null, o)) |
| 51 | + if (!o['plan-hash']) throw err('PLAN_HASH_REQUIRED', 'PLAN_HASH_REQUIRED: run `shadow-dev bind plan` first or pass --plan-hash', 2) |
| 52 | + if (o['plan-hash'] !== e.planHash) throw err('PLAN_HASH_INVALID') |
| 53 | + const x = e.data |
| 54 | + const blocked = x.hosts.flatMap(h => h.entries.filter(t => t.blocked).map(t => `${h.host}:${t.skill}`)) |
| 55 | + if (blocked.length) throw err('UNMANAGED_TARGET', `UNMANAGED_TARGET: refusing to overwrite unmanaged skill dirs (${blocked.join(', ')}); remove or rename them first`, 1) |
| 56 | + const bound = [] |
| 57 | + for (const h of x.hosts) { |
| 58 | + mkdirSync(h.skillsDir, { recursive: true }) |
| 59 | + const skills = {} |
| 60 | + for (const t of h.entries) { |
| 61 | + rmSync(t.target, { recursive: true, force: true }) |
| 62 | + cpSync(join(x.artifactRoot, 'skills', t.skill), t.target, { recursive: true }) |
| 63 | + skills[t.skill] = { hash: dirHash(t.target) } |
| 64 | + bound.push(`${h.host}:${t.skill}`) |
| 65 | + } |
| 66 | + writeFileSync(join(h.skillsDir, SIDECAR), JSON.stringify({ schema: 'shadow-dev-bind/v1', marker: 'managed-by: shadow-dev-workflow', version: x.version, skills }, null, 2)) |
| 67 | + } |
| 68 | + return { action: 'bind', bound } |
| 69 | +} |
| 70 | + |
| 71 | +export function unbindDomain(o) { |
| 72 | + confirm(o) |
| 73 | + if (!o.host || o.host === 'auto') throw err('HOST_REQUIRED', 'HOST_REQUIRED: pass --host <name> for unbind', 1) |
| 74 | + const root = resolvedRoot(o) |
| 75 | + const adapter = loadAdapters(root).find(a => a.host === o.host) |
| 76 | + if (!adapter) throw err('HOST_NOT_FOUND', `HOST_NOT_FOUND: no adapter for host "${o.host}"`, 1) |
| 77 | + const dir = skillsDirOf(adapter) |
| 78 | + const sidecar = sidecarRead(dir) |
| 79 | + if (!sidecar || !sidecar.skills || !Object.keys(sidecar.skills).length) throw err('NOTHING_TO_UNBIND', `NOTHING_TO_UNBIND: no shadow-dev-workflow managed skills under ${dir}`, 1) |
| 80 | + const removed = Object.keys(sidecar.skills) |
| 81 | + for (const skill of removed) rmSync(join(dir, skill), { recursive: true, force: true }) |
| 82 | + rmSync(join(dir, SIDECAR), { force: true }) |
| 83 | + return { action: 'unbind', host: o.host, removed } |
| 84 | +} |
| 85 | + |
| 86 | +export function statusDomain(o) { |
| 87 | + let root = null |
| 88 | + try { root = resolvedRoot(o) } catch { return { installed: false, hosts: [] } } |
| 89 | + const hosts = loadAdapters(root).map(a => { |
| 90 | + const dir = skillsDirOf(a) |
| 91 | + const sidecar = sidecarRead(dir) |
| 92 | + return { host: a.host, tier: a.tier || null, skillsDir: dir, present: existsSync(dir), managed: sidecar && sidecar.skills ? Object.keys(sidecar.skills) : [] } |
| 93 | + }) |
| 94 | + return { installed: true, artifactRoot: root, version: verOf(root), hosts } |
| 95 | +} |
| 96 | + |
| 97 | +export async function handle(a, o) { |
| 98 | + if (a === 'plan') return plan('bind', planData(null, o)) |
| 99 | + if (a === 'execute') return { ok: true, command: 'bind.execute', data: executeDomain(o) } |
| 100 | + if (a === 'status') return { ok: true, command: 'bind.status', data: statusDomain(o) } |
| 101 | + if (a === 'unbind') return { ok: true, command: 'bind.unbind', data: unbindDomain(o) } |
| 102 | + throw err('UNKNOWN_COMMAND', `unsupported command: bind ${a}`) |
| 103 | +} |
0 commit comments