mn-ws 0.1.0 → 0.2.0

package/dist/core/session.js.map

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

package/dist/core/skills/bus.d.ts

@@ -0,0 +1,29 @@
+import { type HookHandlerSpec } from './handlers.js';
+export declare const HOOK_CONFIG_FILE = "hooks.json";
+export interface HookRule {
+    match: string;
+    hooks: HookHandlerSpec[];
+}
+export interface HookConfig {
+    dir: string;
+    hooks: Record<string, HookRule[]>;
+}
+export declare function loadHookConfig(dir: string): Promise<HookConfig | null>;
+export interface HookOutcome {
+    ran: number;
+    blocked: boolean;
+    reason?: string;
+    by: string;
+    vars: Record<string, string>;
+    data: unknown[];
+}
+interface RunEventInput {
+    event: string;
+    target: string;
+    configs: Array<HookConfig | null>;
+    fields?: Record<string, unknown>;
+}
+export declare function runHookEvent(input: RunEventInput): Promise<HookOutcome>;
+export declare function emit(event: string, target: string, config: HookConfig | null, fields?: Record<string, unknown>): Promise<HookOutcome>;
+export {};
+//# sourceMappingURL=bus.d.ts.map

package/dist/core/skills/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../../src/core/skills/bus.ts"],"names":[],"mappings":"AAyBA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAE7C,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;CACnC;AAGD,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA4C5E;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAElC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAID,wBAAsB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAiC7E;AAGD,wBAAsB,IAAI,CACxB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,GAAG,IAAI,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,WAAW,CAAC,CAEtB"}

package/dist/core/skills/bus.js

@@ -0,0 +1,114 @@
+// 通用 hook 总线：配置文件桥接、match 过滤、无限事件平面。
+//
+// 模型参考 Claude Code hooks（settings.json → hooks → 事件组 → matcher → handlers），
+// 在 nx-nx 内落地为每个 skill / 项目可自带的 hooks.json：
+//
+// {
+//   "version": 1,
+//   "hooks": {
+//     "<任意事件名>": [
+//       { "match": "<正则，匹配 target>",
+//         "hooks": [ { "type": "module", "use": "./x.mjs" },
+//                    { "type": "command", "command": "node y.mjs" } ] }
+//     ]
+//   }
+// }
+//
+// 关键性质：
+//   1. 事件平面开放——核心不枚举事件，任意字符串都能注册与触发（无限平面扩展）
+//   2. match = 正则白名单，只在 target 命中时执行该规则
+//   3. handler 顺序执行；decision.vars 聚合、decision.block 立即阻断
+//   4. 配置 schema / 坏 JSON / 坏正则一律显眼报错（作者资产，不静默）
+import fsp from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { specError } from '../errors/index.js';
+import { runHandler, } from './handlers.js';
+export const HOOK_CONFIG_FILE = 'hooks.json';
+// 加载目录下的 hooks.json；不存在 → null（无钩子）；坏 JSON / schema 错 → 抛错。
+export async function loadHookConfig(dir) {
+    const file = join(dir, HOOK_CONFIG_FILE);
+    if (!existsSync(file))
+        return null;
+    let raw;
+    try {
+        raw = await fsp.readFile(file, 'utf8');
+    }
+    catch (e) {
+        throw specError(`无法读取 ${HOOK_CONFIG_FILE}: ${String(e.message || e)}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw specError(`${HOOK_CONFIG_FILE} 不是合法 JSON（目录: ${dir}）`);
+    }
+    const groups = parsed.hooks;
+    if (!groups || typeof groups !== 'object') {
+        throw specError(`${HOOK_CONFIG_FILE} schema 错误：缺少 hooks 对象（目录: ${dir}）`);
+    }
+    for (const [event, rules] of Object.entries(groups)) {
+        if (!Array.isArray(rules) || !rules.length) {
+            throw specError(`${HOOK_CONFIG_FILE} 事件 "${event}" 必须是非空规则数组`);
+        }
+        for (const rule of rules) {
+            if (typeof rule.match !== 'string' || !rule.match) {
+                throw specError(`${HOOK_CONFIG_FILE} 事件 "${event}" 的规则缺少非空 match`);
+            }
+            try {
+                new RegExp(rule.match);
+            }
+            catch (e) {
+                throw specError(`${HOOK_CONFIG_FILE} 事件 "${event}" 的 match 不是合法正则: ${rule.match}（${String(e.message)}）`);
+            }
+            if (!Array.isArray(rule.hooks) || !rule.hooks.length) {
+                throw specError(`${HOOK_CONFIG_FILE} 事件 "${event}" 的规则缺少非空 hooks 数组`);
+            }
+        }
+    }
+    return { dir, hooks: groups };
+}
+// 触发一个事件：汇总各配置中该事件的规则，match 命中则顺序执行 handlers。
+// 事件名任意——总线不认识固定平面，新事件无需改核心。
+export async function runHookEvent(input) {
+    const outcome = { ran: 0, blocked: false, vars: {}, data: [], by: '' };
+    for (const config of input.configs) {
+        if (!config)
+            continue;
+        const rules = config.hooks[input.event];
+        if (!rules)
+            continue;
+        for (const rule of rules) {
+            if (!new RegExp(rule.match).test(input.target))
+                continue;
+            const payload = {
+                ...input.fields,
+                event: input.event,
+                target: input.target,
+                match: rule.match,
+                cwd: input.fields?.cwd || process.cwd(),
+            };
+            for (const handler of rule.hooks) {
+                const decision = await runHandler(handler, config.dir, payload);
+                outcome.ran++;
+                if (decision?.vars)
+                    Object.assign(outcome.vars, decision.vars);
+                if (decision?.data !== undefined)
+                    outcome.data.push(decision.data);
+                if (decision?.block) {
+                    outcome.blocked = true;
+                    outcome.reason = decision.block;
+                    outcome.by = handler.use || handler.command || 'handler';
+                    return outcome;
+                }
+            }
+        }
+    }
+    return outcome;
+}
+// 便捷封装：单配置来源。
+export async function emit(event, target, config, fields) {
+    return runHookEvent({ event, target, configs: [config], fields });
+}
+//# sourceMappingURL=bus.js.map

package/dist/core/skills/bus.js.map

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

package/dist/core/skills/get.d.ts

@@ -0,0 +1,17 @@
+import { installOne } from './index.js';
+export interface SkillGetResult {
+    skillName: string;
+    ref: string;
+    content: string;
+    contentBytes: number;
+    install: Awaited<ReturnType<typeof installOne>>;
+}
+export declare function listRefs(name: unknown): Promise<string[]>;
+export declare function getSkill(name: unknown, opts?: {
+    ref?: string;
+    to?: string;
+    force?: boolean;
+}): Promise<SkillGetResult>;
+export declare function skillGetPrefix(name: string, ref: string): string;
+export declare function installStatusLine(r: Awaited<ReturnType<typeof installOne>>): string;
+//# sourceMappingURL=get.d.ts.map

package/dist/core/skills/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/core/skills/get.ts"],"names":[],"mappings":"AAOA,OAAO,EAA+B,UAAU,EAAE,MAAM,YAAY,CAAC;AAIrE,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC;CACjD;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAS/D;AA+BD,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,OAAO,EACb,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GACxD,OAAO,CAAC,cAAc,CAAC,CAiBzB;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQhE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,GAAG,MAAM,CAOnF"}

package/dist/core/skills/get.js

@@ -0,0 +1,87 @@
+// skill get：把指定 skill 的文档导出给外部 agent，并顺手幂等安装。
+// 与 skills.ts 分开：一个管安装/分组，一个管文档读取，各自不超限。
+import fsp from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { badInput, notFound } from '../errors/index.js';
+import { assertSafeName } from '../paths.js';
+import { assetsDir, defaultSkillsDir, installOne } from './index.js';
+const SENTINEL = '# --- begin skill content (do not modify this line) ---';
+export async function listRefs(name) {
+    const safe = assertSafeName(name, 'skill 名');
+    const dir = join(assetsDir(), safe, 'references');
+    try {
+        const entries = await fsp.readdir(dir);
+        return entries.filter((f) => f.endsWith('.md')).map((f) => f.replace(/\.md$/, '')).sort();
+    }
+    catch {
+        return [];
+    }
+}
+// 解析 ref 到 skill 内的相对路径：
+//   空 / SKILL.md → SKILL.md；裸名 → references/<裸名>.md（再退到 <裸名>.md）；
+//   含 / 的显式路径去掉 ./ 前缀。任何 '..' 或越界一律拒绝。
+async function resolveRefPath(name, ref) {
+    let rel;
+    if (!ref || ref === 'SKILL.md') {
+        rel = 'SKILL.md';
+    }
+    else if (ref.includes('/')) {
+        rel = ref.replace(/^\.\//, '');
+    }
+    else {
+        const a = join(assetsDir(), name, 'references', `${ref}.md`);
+        const b = join(assetsDir(), name, `${ref}.md`);
+        rel = existsSync(a) ? join('references', `${ref}.md`) : existsSync(b) ? `${ref}.md` : null;
+        if (!rel) {
+            const refs = await listRefs(name);
+            throw badInput(`未知 ref: ${ref}（可用: SKILL.md, ${refs.join(', ')}）`);
+        }
+    }
+    if (rel.split(/[\\/]/).includes('..')) {
+        throw badInput(`ref 路径不允许包含 '..': ${ref}`);
+    }
+    const base = join(assetsDir(), name);
+    const resolved = join(base, rel);
+    if (!resolved.startsWith(base))
+        throw badInput(`ref 越界: ${ref}`);
+    // 文档路径随包跨平台分发，统一用正斜杠
+    return rel.replace(/\\/g, '/');
+}
+export async function getSkill(name, opts = {}) {
+    const safe = assertSafeName(name, 'skill 名');
+    if (!existsSync(join(assetsDir(), safe, 'SKILL.md'))) {
+        throw notFound(`未找到内置 skill: ${safe}`);
+    }
+    const rel = await resolveRefPath(safe, opts.ref || '');
+    const file = join(assetsDir(), safe, rel);
+    let content;
+    try {
+        content = await fsp.readFile(file, 'utf8');
+    }
+    catch {
+        throw notFound(`未找到 skill 文档: ${safe}/${rel}`);
+    }
+    const install = await installOne(safe, { to: opts.to || defaultSkillsDir(), force: opts.force });
+    return { skillName: safe, ref: rel, content, contentBytes: Buffer.byteLength(content, 'utf8'), install };
+}
+// 人读模式的前缀：sentinel 行给 agent 明确的复制边界。
+export function skillGetPrefix(name, ref) {
+    return [
+        `# === ${name} skill context ===`,
+        `# 以下内容来自 ${name} skill 的 ${ref || 'SKILL.md'}。`,
+        `# 建议：把 sentinel 行之后的全文复制到 .claude/skills/${name}/ 下，便于后续会话复用。`,
+        SENTINEL,
+        '',
+    ].join('\n');
+}
+export function installStatusLine(r) {
+    if (r.status === 'conflict') {
+        return `-- install 状态 --\n冲突: ${r.path}（${r.files} 个文件不同；确认覆盖加 --force）`;
+    }
+    if (r.status === 'skipped')
+        return `-- install 状态 --\n已是最新: ${r.path}`;
+    const verb = r.replaced ? '已替换' : '已安装';
+    return `-- install 状态 --\n${verb}: ${r.path}（${r.files} 个文件）`;
+}
+//# sourceMappingURL=get.js.map

package/dist/core/skills/get.js.map

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

package/dist/core/skills/handlers.d.ts

@@ -0,0 +1,22 @@
+export interface HookHandlerSpec {
+    type?: 'module' | 'command';
+    use?: string;
+    command?: string;
+    timeoutMs?: number;
+}
+export type HookPayload = {
+    event: string;
+    target: string;
+    match: string;
+    cwd: string;
+    [k: string]: unknown;
+};
+export interface HookDecision {
+    block?: string;
+    vars?: Record<string, string>;
+    data?: unknown;
+}
+export declare function runModuleHandler(spec: HookHandlerSpec, configDir: string, payload: HookPayload): Promise<HookDecision | void>;
+export declare function runCommandHandler(spec: HookHandlerSpec, configDir: string, payload: HookPayload): Promise<HookDecision | void>;
+export declare function runHandler(spec: HookHandlerSpec, configDir: string, payload: HookPayload): Promise<HookDecision | void>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/core/skills/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/core/skills/handlers.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAE5B,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB,CAAC;AAGF,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAKD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAqB9B;AAGD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA8C9B;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAK9B"}

package/dist/core/skills/handlers.js

@@ -0,0 +1,86 @@
+// hook handler 执行器：两种类型，同一套 payload / decision 协议。
+//
+//   module： import 配置目录内的 ESM 模块，调用导出函数，函数返回 decision
+//   command：spawn 子进程（语言无关），payload JSON 走 stdin；
+//            stdout 的 JSON 为 decision；exit 2 = 阻断（stderr 作为反馈，
+//            对齐 Claude Code hooks 的 blocking 约定）；其余非 0 = 执行错误
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { isAbsolute, resolve, sep } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { external, specError } from '../errors/index.js';
+const DEFAULT_TIMEOUT_MS = 15_000;
+// module handler：解析并校验路径（必须在配置目录内），import 后调用。
+export async function runModuleHandler(spec, configDir, payload) {
+    if (!spec.use)
+        throw specError('module handler 缺少 "use" 字段');
+    const parts = spec.use.split('#');
+    const rel = parts[0] || '';
+    const exportName = parts[1];
+    const abs = isAbsolute(rel) ? rel : resolve(configDir, rel);
+    // 防越界：解析结果必须仍在配置目录内
+    const inside = abs === configDir || abs.startsWith(configDir.endsWith(sep) ? configDir : configDir + sep);
+    if (!inside) {
+        throw specError(`hook 模块路径越出配置目录: ${spec.use}`);
+    }
+    if (!existsSync(abs))
+        throw specError(`hook 模块不存在: ${spec.use}`);
+    const mod = await import(pathToFileURL(abs).href);
+    const fn = exportName ? mod[exportName] : mod.default;
+    if (typeof fn !== 'function') {
+        throw specError(`hook 模块 ${spec.use} 的 ${exportName || 'default'} 不是函数`);
+    }
+    return (await fn(payload));
+}
+// command handler：子进程 + stdin JSON + stdout JSON / exit 2 阻断。
+export function runCommandHandler(spec, configDir, payload) {
+    if (!spec.command || !spec.command.trim()) {
+        throw specError('command handler 缺少 "command" 字段');
+    }
+    const timeoutMs = spec.timeoutMs || DEFAULT_TIMEOUT_MS;
+    return new Promise((resolvePromise, rejectPromise) => {
+        const child = spawn(spec.command, {
+            cwd: configDir,
+            shell: true,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        const timer = setTimeout(() => {
+            child.kill('SIGTERM');
+            rejectPromise(external(`hook 命令超时（${timeoutMs}ms）: ${spec.command}`));
+        }, timeoutMs);
+        child.stdout.on('data', (b) => (stdout += b.toString()));
+        child.stderr.on('data', (b) => (stderr += b.toString()));
+        child.on('error', rejectPromise);
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            if (code === 0) {
+                const t = stdout.trim();
+                if (!t)
+                    return resolvePromise();
+                try {
+                    return resolvePromise(JSON.parse(t));
+                }
+                catch {
+                    return rejectPromise(external(`hook 命令 stdout 不是合法 JSON: ${spec.command}（${t.slice(0, 80)}）`));
+                }
+            }
+            if (code === 2) {
+                return resolvePromise({ block: stderr.trim() || `hook 阻断: ${spec.command}` });
+            }
+            rejectPromise(external(`hook 命令退出码 ${code}: ${spec.command}${stderr ? '\n' + stderr.trim() : ''}`));
+        });
+        child.stdin.write(JSON.stringify(payload));
+        child.stdin.end();
+    });
+}
+export async function runHandler(spec, configDir, payload) {
+    const type = spec.type || (spec.command ? 'command' : 'module');
+    if (type === 'command')
+        return runCommandHandler(spec, configDir, payload);
+    if (type === 'module')
+        return runModuleHandler(spec, configDir, payload);
+    throw specError(`未知 hook handler 类型: ${String(type)}`);
+}
+//# sourceMappingURL=handlers.js.map

package/dist/core/skills/handlers.js.map

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

package/dist/core/skills/index.d.ts

@@ -0,0 +1,47 @@
+import { type AbsolutePath } from '../brand.js';
+export declare function assetsDir(): AbsolutePath;
+export declare const defaultSkillsDir: () => AbsolutePath;
+export interface GroupSpec {
+    skills: string[];
+    summary?: string;
+}
+export interface GroupsManifest {
+    groups: Record<string, GroupSpec>;
+    defaultGroup: string | null;
+    source: 'manifest' | 'assets-dirs';
+    warning?: string;
+}
+export declare function loadGroups(): Promise<GroupsManifest>;
+export declare function bundledSkillNames(): Promise<string[]>;
+export interface InstallResult {
+    status: 'ok' | 'conflict' | 'skipped';
+    name: string;
+    path: string;
+    files: number;
+    installed?: boolean;
+    replaced?: boolean;
+}
+export declare function inspectInstall(name: unknown, toRoot?: string): Promise<{
+    name: string;
+    path: string;
+    changed: string[];
+    dstExisted: boolean;
+}>;
+export declare function installOne(name: unknown, opts?: {
+    to?: string;
+    force?: boolean;
+}): Promise<InstallResult>;
+export interface GroupInstallResult {
+    status: 'ok' | 'conflict';
+    group: string;
+    skills: InstallResult[];
+}
+export declare function installGroup(group: unknown, opts?: {
+    to?: string;
+    force?: boolean;
+}): Promise<GroupInstallResult>;
+export declare function installAll(opts?: {
+    to?: string;
+    force?: boolean;
+}): Promise<GroupInstallResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/skills/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAYhE,wBAAgB,SAAS,IAAI,YAAY,CAYxC;AAED,eAAO,MAAM,gBAAgB,QAAO,YAC0D,CAAC;AAE/F,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,UAAU,GAAG,aAAa,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,wBAAsB,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC,CA2C1D;AAkBD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAW3D;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,SAAS,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAID,wBAAsB,cAAc,CAClC,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,CAUjF;AAOD,wBAAsB,UAAU,CAC9B,IAAI,EAAE,OAAO,EACb,IAAI,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,OAAO,CAAC,aAAa,CAAC,CAyDxB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,IAAI,GAAG,UAAU,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAGD,wBAAsB,YAAY,CAChC,KAAK,EAAE,OAAO,EACd,IAAI,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,OAAO,CAAC,kBAAkB,CAAC,CAQ7B;AAID,wBAAsB,UAAU,CAC9B,IAAI,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,OAAO,CAAC,kBAAkB,CAAC,CAI7B"}