@skillfm/local 2.0.4 → 2.0.6

package/dist/harness/kernels/registry.js

@@ -0,0 +1,139 @@
+/**
+ * BSO M9 v0.3 — Layer 3 KernelAdapter 注册表 + 装配
+ *
+ * Refs:
+ *   - docs/prd/PRD-BSO-M9-HARNESS-HOOKS.md §3.4.3
+ *
+ * `installAll(host)`：根据 host 命中所有匹配的 adapter，并行 install。
+ * 多内核共存策略：M9 P0 取强制力最强的一类（hook-file > deny-pipeline > mcp-only）。
+ *
+ * 用法：
+ *   ```ts
+ *   const host = detectHostInfo();
+ *   const report = await installAll({ host, cwd: process.cwd(), apply: true });
+ *   ```
+ */
+import { detectHarness } from '../detector.js';
+import { hookFileAdapter } from './hook-file.js';
+import { denyPipelineAdapter } from './deny-pipeline.js';
+import { mcpOnlyAdapter, scanMcpOnlyHosts } from './mcp-only.js';
+import { protocolRejectAdapter } from './protocol-reject.js';
+// ============================================================================
+// 注册表（顺序 = 强制力降序）
+// ============================================================================
+export const REGISTRY = [
+    hookFileAdapter,
+    denyPipelineAdapter,
+    mcpOnlyAdapter,
+    // protocolRejectAdapter 不参与 installAll（matches=false），仅 diagnoseAll 引用
+];
+export const ALL_ADAPTERS = [
+    ...REGISTRY,
+    protocolRejectAdapter,
+];
+export function getAdapter(kind) {
+    return ALL_ADAPTERS.find((a) => a.kind === kind);
+}
+// ============================================================================
+// 检测 → host info
+// ============================================================================
+/**
+ * detectHarness 只识别 v0.2 的 5 个 IDE/CLI host；v0.3 新增的 mcp-only host
+ * （Claude Desktop / 5ire / Tome / Witsy）需要走配置文件扫描。
+ *
+ * 策略：
+ *   1. detector 命中 → 返回该 host
+ *   2. detector unknown → 扫 mcp-only 候选；若有命中且唯一 → 返回该 host
+ *   3. 多个候选或无候选 → 返回 unknown
+ */
+export function detectPrimaryHost() {
+    const det = detectHarness();
+    if (det.harness !== 'unknown') {
+        return {
+            host: det.harness,
+            source: 'detected',
+            reason: det.reason,
+        };
+    }
+    const scanned = scanMcpOnlyHosts();
+    if (scanned.length === 1) {
+        return scanned[0];
+    }
+    if (scanned.length > 1) {
+        return {
+            host: 'unknown',
+            source: 'scanned',
+            reason: `multiple mcp-only hosts found: ${scanned.map((s) => s.host).join(', ')}; use --host=<name> to disambiguate`,
+        };
+    }
+    return {
+        host: 'unknown',
+        source: 'detected',
+        reason: det.reason,
+    };
+}
+export async function installAll(opts) {
+    const ctx = {
+        host: opts.host,
+        cwd: opts.cwd,
+        apply: opts.apply,
+    };
+    const matched = opts.forceKernel
+        ? ALL_ADAPTERS.filter((a) => a.kind === opts.forceKernel)
+        : REGISTRY.filter((a) => a.matches(opts.host));
+    const results = [];
+    const warnings = [];
+    if (matched.length === 0) {
+        warnings.push(`host ${opts.host.host} 未命中任何 Layer 3 内核；仅 Layer 1 SKILL.md priming 生效`);
+    }
+    else {
+        // 顺序执行（避免 backup 时戳冲突）
+        for (const adapter of matched) {
+            try {
+                const r = await adapter.install(ctx);
+                results.push(r);
+                warnings.push(...r.warnings);
+            }
+            catch (err) {
+                warnings.push(`${adapter.kind} install 失败: ${err.message}`);
+            }
+        }
+    }
+    // mcp-only 额外 host
+    if (opts.alsoInstallMcpHosts && opts.alsoInstallMcpHosts.length > 0) {
+        for (const h of opts.alsoInstallMcpHosts) {
+            const subCtx = {
+                host: { host: h, source: 'forced' },
+                cwd: opts.cwd,
+                apply: opts.apply,
+            };
+            try {
+                const r = await mcpOnlyAdapter.install(subCtx);
+                results.push(r);
+                warnings.push(...r.warnings);
+            }
+            catch (err) {
+                warnings.push(`mcp-only ${h} install 失败: ${err.message}`);
+            }
+        }
+    }
+    return {
+        host: opts.host,
+        matched: matched.map((a) => a.kind),
+        results,
+        warnings,
+    };
+}
+export async function diagnoseAll(host, cwd) {
+    const ctx = { host, cwd, apply: false };
+    const layer3 = await Promise.all(REGISTRY.filter((a) => a.matches(host)).map((a) => a.diagnose(ctx)));
+    const layer2 = await protocolRejectAdapter.diagnose(ctx);
+    return { host, layer3, layer2 };
+}
+// ============================================================================
+// 兼容映射：把 detector.Harness 映射到 HostId
+// ============================================================================
+export function harnessToHostId(h) {
+    return h;
+}
+//# sourceMappingURL=registry.js.map

package/dist/harness/kernels/registry.js.map

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

package/dist/harness/kernels/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * BSO M9 v0.3 — KernelAdapter 抽象（Layer 3）
+ *
+ * Refs:
+ *   - docs/prd/PRD-BSO-M9-HARNESS-HOOKS.md §3.4
+ *
+ * 哲学转向：v0.2 是 "N harness × N adapter" 扁平设计；v0.3 改为
+ * "K 类机制内核 × N host 模板" 抽象 — 一类内核覆盖 N 个 host，
+ * 新 host 95% 归入已有内核类别零额外开发。
+ *
+ * P0 内核（M9）：
+ *   - hook-file       (Claude Code / Cursor 1.7+ / Windsurf)
+ *   - deny-pipeline   (OpenClaw)
+ *   - mcp-only        (Claude Desktop / 5ire / Tome / Witsy)
+ *   - protocol-reject (Layer 2 联动占位，无独立 install/uninstall)
+ *
+ * P1+ 内核（M9 之后）：hook-executable / lifecycle-decorator /
+ *   filter-pipeline / memory-block / ...（详见 PRD §8）。
+ */
+import type { Harness } from '../detector.js';
+export type KernelType = 'hook-file' | 'deny-pipeline' | 'mcp-only' | 'protocol-reject';
+/**
+ * 候选 host 标识。注：不复用 Harness 类型 — 因为 mcp-only 内核覆盖了
+ * detector.ts 之前没有的 host（Claude Desktop / 5ire / Tome / Witsy）。
+ */
+export type HostId = Harness | 'claude-desktop' | '5ire' | 'tome' | 'witsy';
+export interface HostInfo {
+    /** 命中的 host 名 */
+    host: HostId;
+    /** 命中来源（detector / 用户 --host=... / mcp-only 全候选扫描）*/
+    source: 'detected' | 'forced' | 'scanned';
+    /** 可读提示（doctor 用） */
+    reason?: string;
+    /** harness 版本，未知则 undefined */
+    version?: string;
+}
+export interface InstallContext {
+    host: HostInfo;
+    cwd: string;
+    /** 写入是否真正落盘；false 时只 dry-run（doctor 用） */
+    apply: boolean;
+}
+export interface InstalledFile {
+    /** 文件绝对路径 */
+    path: string;
+    /** 操作类型 */
+    action: 'created' | 'merged' | 'already-registered' | 'replaced' | 'noop';
+    /** 备份路径（若有） */
+    backup?: string;
+    /** 备注 */
+    details?: string;
+}
+export interface InstallResult {
+    kernel: KernelType;
+    host: HostId;
+    /** 写入的文件清单 */
+    files: InstalledFile[];
+    /** 警告（不阻断 init） */
+    warnings: string[];
+}
+export interface DiagnoseResult {
+    kernel: KernelType;
+    host: HostId;
+    /** 该内核当前的强制力等级 */
+    level: 'strong' | 'protocol-fallback' | 'soft' | 'absent';
+    /** 子检查项（每条独立） */
+    checks: Array<{
+        name: string;
+        ok: boolean;
+        detail?: string;
+    }>;
+}
+export interface KernelAdapter {
+    kind: KernelType;
+    /** 该 adapter 覆盖的所有 host */
+    supportedHosts: readonly HostId[];
+    /** 当前 host 是否归入该内核类别 */
+    matches(host: HostInfo): boolean;
+    /** 安装：写入配置文件 + 注册 hooks/MCP/deny */
+    install(ctx: InstallContext): Promise<InstallResult>;
+    /** 卸载：恢复 .bak / 移除注册项 */
+    uninstall(ctx: InstallContext): Promise<InstallResult>;
+    /** 诊断：检查该 host 当前 install 状态 */
+    diagnose(ctx: InstallContext): Promise<DiagnoseResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/harness/kernels/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/harness/kernels/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAM9C,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,eAAe,GACf,UAAU,GACV,iBAAiB,CAAC;AAMtB;;;GAGG;AACH,MAAM,MAAM,MAAM,GACd,OAAO,GACP,gBAAgB,GAChB,MAAM,GACN,MAAM,GACN,OAAO,CAAC;AAEZ,MAAM,WAAW,QAAQ;IACvB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC1C,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,MAAM,EACF,SAAS,GACT,QAAQ,GACR,oBAAoB,GACpB,UAAU,GACV,MAAM,CAAC;IACX,eAAe;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS;IACT,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,EAAE,QAAQ,GAAG,mBAAmB,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC1D,iBAAiB;IACjB,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,OAAO,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAMD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IAEjB,2BAA2B;IAC3B,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAElC,wBAAwB;IACxB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IAEjC,oCAAoC;IACpC,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAErD,yBAAyB;IACzB,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEvD,gCAAgC;IAChC,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACxD"}

package/dist/harness/kernels/types.js

@@ -0,0 +1,21 @@
+/**
+ * BSO M9 v0.3 — KernelAdapter 抽象（Layer 3）
+ *
+ * Refs:
+ *   - docs/prd/PRD-BSO-M9-HARNESS-HOOKS.md §3.4
+ *
+ * 哲学转向：v0.2 是 "N harness × N adapter" 扁平设计；v0.3 改为
+ * "K 类机制内核 × N host 模板" 抽象 — 一类内核覆盖 N 个 host，
+ * 新 host 95% 归入已有内核类别零额外开发。
+ *
+ * P0 内核（M9）：
+ *   - hook-file       (Claude Code / Cursor 1.7+ / Windsurf)
+ *   - deny-pipeline   (OpenClaw)
+ *   - mcp-only        (Claude Desktop / 5ire / Tome / Witsy)
+ *   - protocol-reject (Layer 2 联动占位，无独立 install/uninstall)
+ *
+ * P1+ 内核（M9 之后）：hook-executable / lifecycle-decorator /
+ *   filter-pipeline / memory-block / ...（详见 PRD §8）。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/harness/kernels/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/harness/kernels/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}