@skillfm/local 2.0.0 → 2.0.3

package/dist/harness/templates.js.map

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

package/dist/harness/writers.d.ts

@@ -0,0 +1,82 @@
+/**
+ * BSO M9-2 — 配置写入器（idempotent + backup）
+ *
+ * Refs: docs/prd/PRD-BSO-M9-HARNESS-HOOKS.md §3.3 + §7.3 回滚
+ *
+ * 职责：
+ *   - 写 LLM priming block 到 CLAUDE.md / AGENTS.md（追加在尾部，用 SKILLFM-BEGIN/END 边界，
+ *     复用 soul.ts 的 block 机制，已存在则先撤再写 → 唯一）
+ *   - 合并（不覆盖）Claude Code settings.json 的 hooks
+ *   - 合并 Aider .aider.conf.yml 的 commands_pre/post
+ *   - 所有写入前都 backup 原文件到 ~/.skillfm/backups/<ts>/
+ *   - 所有操作 idempotent — 已注册则 skip
+ *
+ * 不实现：
+ *   - PR #7 已落的 soul 文件写入（writeSkillfmBlock 在 soul.ts）— priming 和 soul block
+ *     是同一个 BEGIN/END 边界块，共用一套基础设施
+ *   - MCP stdio bridge（需要另做，M9 范围外）
+ */
+import { type AiderConfigPatch, type ClaudeSettingsPatch, type HarnessPaths } from './templates.js';
+import type { Harness } from './detector.js';
+import { type PrimingLang } from './priming.js';
+export type HarnessWriterErrorCode = 'SKILLFM.HARNESS.UNSUPPORTED' | 'SKILLFM.HARNESS.WRITE_FAILED' | 'SKILLFM.HARNESS.PARSE_FAILED';
+export declare class HarnessWriterError extends Error {
+    code: HarnessWriterErrorCode;
+    constructor(code: HarnessWriterErrorCode, message: string);
+}
+export interface InitReport {
+    harness: Harness;
+    paths: HarnessPaths;
+    llm_priming: {
+        file: string;
+        action: 'created' | 'appended' | 'replaced' | 'already-present';
+    };
+    harness_config: {
+        file: string | null;
+        action: 'created' | 'merged' | 'already-registered' | 'skipped-no-hook-support' | 'skipped-no-config-file';
+        details?: string;
+    };
+    warnings: string[];
+}
+/**
+ * 把 priming block 写入目标文件。BEGIN/END 边界。
+ * 已存在 → 先移除旧的再追加新的（upgrade-safe）。
+ */
+export declare function writePrimingBlock(filePath: string, lang?: PrimingLang): {
+    action: InitReport['llm_priming']['action'];
+    bytesWritten: number;
+};
+/**
+ * additive merge：
+ *   - 已有 hooks.SessionStart / PreToolUse / PostToolUse 保留
+ *   - 我们的 hooks（identified by command startsWith(SKILLFM_GUARD_COMMAND)）已在则 skip
+ *   - 否则 append
+ */
+export declare function mergeClaudeSettings(filePath: string, patch: ClaudeSettingsPatch): {
+    action: InitReport['harness_config']['action'];
+    details?: string;
+};
+/**
+ * Aider 配置用 YAML，但我们只需要设置 `commands_pre` / `commands_post` 两个 list。
+ * 避免引入 `js-yaml` 依赖（@skillfm/local 坚持 zero-dep）— 手写 minimal YAML writer。
+ *
+ * 策略：
+ *   - 文件不存在 → 创建只含我们的两个 key
+ *   - 文件存在 → 读为字符串，grep `commands_pre:` / `commands_post:` 是否已含我们的命令；
+ *     已含则 skip，否则追加
+ *
+ * 不尝试全解析 YAML（复杂度高、易出错），只做 append-safe 操作。
+ */
+export declare function mergeAiderConfig(filePath: string, patch: AiderConfigPatch): {
+    action: InitReport['harness_config']['action'];
+    details?: string;
+};
+export interface InitHarnessOptions {
+    harness: Harness;
+    cwd: string;
+    lang?: PrimingLang;
+    /** 若为 true，跳过 harness 层写入（只写 LLM 层 priming）*/
+    llmOnly?: boolean;
+}
+export declare function initHarness(opts: InitHarnessOptions): InitReport;
+//# sourceMappingURL=writers.d.ts.map

package/dist/harness/writers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writers.d.ts","sourceRoot":"","sources":["../../src/harness/writers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAgD,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAO9F,MAAM,MAAM,sBAAsB,GAC9B,6BAA6B,GAC7B,8BAA8B,GAC9B,8BAA8B,CAAC;AAEnC,qBAAa,kBAAmB,SAAQ,KAAK;IACxB,IAAI,EAAE,sBAAsB;gBAA5B,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM;CAIjE;AAMD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,iBAAiB,CAAC;KACjE,CAAC;IACF,cAAc,EAAE;QACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,MAAM,EACF,SAAS,GACT,QAAQ,GACR,oBAAoB,GACpB,yBAAyB,GACzB,wBAAwB,CAAC;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,WAAoB,GACzB;IAAE,MAAM,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAgDvE;AAMD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,mBAAmB,GACzB;IAAE,MAAM,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAsEtE;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,gBAAgB,GACtB;IAAE,MAAM,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CA2CtE;AAMD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,UAAU,CA2DhE"}

package/dist/harness/writers.js

@@ -0,0 +1,266 @@
+/**
+ * BSO M9-2 — 配置写入器（idempotent + backup）
+ *
+ * Refs: docs/prd/PRD-BSO-M9-HARNESS-HOOKS.md §3.3 + §7.3 回滚
+ *
+ * 职责：
+ *   - 写 LLM priming block 到 CLAUDE.md / AGENTS.md（追加在尾部，用 SKILLFM-BEGIN/END 边界，
+ *     复用 soul.ts 的 block 机制，已存在则先撤再写 → 唯一）
+ *   - 合并（不覆盖）Claude Code settings.json 的 hooks
+ *   - 合并 Aider .aider.conf.yml 的 commands_pre/post
+ *   - 所有写入前都 backup 原文件到 ~/.skillfm/backups/<ts>/
+ *   - 所有操作 idempotent — 已注册则 skip
+ *
+ * 不实现：
+ *   - PR #7 已落的 soul 文件写入（writeSkillfmBlock 在 soul.ts）— priming 和 soul block
+ *     是同一个 BEGIN/END 边界块，共用一套基础设施
+ *   - MCP stdio bridge（需要另做，M9 范围外）
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, } from 'node:fs';
+import { dirname } from 'node:path';
+import { aiderConfigPatch, capabilitiesFor, claudeSettingsPatch, pathsFor, SKILLFM_GUARD_COMMAND, } from './templates.js';
+import { wrapPrimingBlock, PRIMING_BEGIN, PRIMING_END } from './priming.js';
+import { backupFileBeforeWrite } from '../soul-security.js';
+export class HarnessWriterError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'HarnessWriterError';
+    }
+}
+// ============================================================================
+// LLM 层写入：priming block
+// ============================================================================
+/**
+ * 把 priming block 写入目标文件。BEGIN/END 边界。
+ * 已存在 → 先移除旧的再追加新的（upgrade-safe）。
+ */
+export function writePrimingBlock(filePath, lang = 'auto') {
+    const block = wrapPrimingBlock(lang);
+    const existed = existsSync(filePath);
+    const original = existed ? readFileSync(filePath, 'utf-8') : '';
+    const alreadyHas = original.includes(PRIMING_BEGIN);
+    // upgrade-safe：如果已经有 block 且完全一致 → no-op
+    if (alreadyHas && original.includes(block.trimEnd())) {
+        return { action: 'already-present', bytesWritten: 0 };
+    }
+    // backup 原文件（若存在）
+    if (existed) {
+        try {
+            backupFileBeforeWrite(filePath, original);
+        }
+        catch {
+            // backup 失败不致命（priming 不同于 soul 写入，非安全关键）
+        }
+    }
+    let next;
+    let action;
+    if (alreadyHas) {
+        // 移除旧 block 再追加新
+        const startIdx = original.indexOf(PRIMING_BEGIN);
+        const endIdx = original.indexOf(PRIMING_END);
+        if (startIdx === -1 || endIdx === -1 || endIdx < startIdx) {
+            throw new HarnessWriterError('SKILLFM.HARNESS.PARSE_FAILED', `${filePath} 含 SKILLFM-BEGIN 但 END 缺失/顺序反转，拒绝自动修复，请手动检查`);
+        }
+        const before = original.slice(0, startIdx).replace(/\n+$/, '\n');
+        const after = original.slice(endIdx + PRIMING_END.length).replace(/^\n+/, '');
+        next = `${before}\n${block}${after}`.replace(/\n{3,}/g, '\n\n');
+        action = 'replaced';
+    }
+    else if (existed) {
+        next = `${original}${original.endsWith('\n') ? '' : '\n'}\n${block}`;
+        action = 'appended';
+    }
+    else {
+        mkdirSync(dirname(filePath), { recursive: true });
+        next = block;
+        action = 'created';
+    }
+    writeFileSync(filePath, next, { encoding: 'utf-8', mode: 0o644 });
+    return { action, bytesWritten: Buffer.byteLength(next, 'utf-8') };
+}
+// ============================================================================
+// Claude Code settings.json 合并
+// ============================================================================
+/**
+ * additive merge：
+ *   - 已有 hooks.SessionStart / PreToolUse / PostToolUse 保留
+ *   - 我们的 hooks（identified by command startsWith(SKILLFM_GUARD_COMMAND)）已在则 skip
+ *   - 否则 append
+ */
+export function mergeClaudeSettings(filePath, patch) {
+    const existed = existsSync(filePath);
+    const original = existed ? readFileSync(filePath, 'utf-8') : '{}';
+    let data;
+    try {
+        data = JSON.parse(original);
+    }
+    catch (err) {
+        throw new HarnessWriterError('SKILLFM.HARNESS.PARSE_FAILED', `${filePath} 不是合法 JSON: ${err.message}`);
+    }
+    if (!data || typeof data !== 'object')
+        data = {};
+    if (!data.hooks || typeof data.hooks !== 'object')
+        data.hooks = {};
+    let addedCount = 0;
+    let skippedCount = 0;
+    const mergeSection = (section) => {
+        const ours = patch.hooks[section];
+        if (!ours)
+            return;
+        if (!Array.isArray(data.hooks[section]))
+            data.hooks[section] = [];
+        for (const entry of ours) {
+            const alreadyHas = data.hooks[section].some((h) => (h.hooks || []).some((x) => typeof x.command === 'string' && x.command.startsWith(SKILLFM_GUARD_COMMAND)));
+            if (alreadyHas) {
+                skippedCount += 1;
+            }
+            else {
+                data.hooks[section].push(entry);
+                addedCount += 1;
+            }
+        }
+    };
+    mergeSection('SessionStart');
+    mergeSection('PreToolUse');
+    mergeSection('PostToolUse');
+    if (existed) {
+        try {
+            backupFileBeforeWrite(filePath, original);
+        }
+        catch {
+            // backup 失败不致命
+        }
+    }
+    else {
+        mkdirSync(dirname(filePath), { recursive: true });
+    }
+    const out = JSON.stringify(data, null, 2) + '\n';
+    writeFileSync(filePath, out, { encoding: 'utf-8', mode: 0o644 });
+    if (addedCount === 0 && skippedCount > 0) {
+        return { action: 'already-registered', details: `all ${skippedCount} hooks already present` };
+    }
+    if (!existed) {
+        return { action: 'created', details: `added ${addedCount} hook(s)` };
+    }
+    return {
+        action: 'merged',
+        details: `added ${addedCount} / skipped ${skippedCount} existing hook(s)`,
+    };
+}
+// ============================================================================
+// Aider .aider.conf.yml 合并（极简 YAML 操作，不引入 yaml 依赖）
+// ============================================================================
+/**
+ * Aider 配置用 YAML，但我们只需要设置 `commands_pre` / `commands_post` 两个 list。
+ * 避免引入 `js-yaml` 依赖（@skillfm/local 坚持 zero-dep）— 手写 minimal YAML writer。
+ *
+ * 策略：
+ *   - 文件不存在 → 创建只含我们的两个 key
+ *   - 文件存在 → 读为字符串，grep `commands_pre:` / `commands_post:` 是否已含我们的命令；
+ *     已含则 skip，否则追加
+ *
+ * 不尝试全解析 YAML（复杂度高、易出错），只做 append-safe 操作。
+ */
+export function mergeAiderConfig(filePath, patch) {
+    const existed = existsSync(filePath);
+    const original = existed ? readFileSync(filePath, 'utf-8') : '';
+    const guardMarker = SKILLFM_GUARD_COMMAND;
+    const alreadyHasPre = original.includes('commands_pre') && original.includes(guardMarker);
+    const alreadyHasPost = original.includes('commands_post') && original.includes(guardMarker);
+    if (alreadyHasPre && alreadyHasPost) {
+        return { action: 'already-registered' };
+    }
+    const header = existed && !original.endsWith('\n') ? `${original}\n` : original;
+    const appendedBlock = [
+        '',
+        '# SkillFM M9 harness hooks (managed by @skillfm/local; edit via `skillfm init`)',
+        `commands_pre:`,
+        ...patch.commands_pre.map((c) => `  - "${c}"`),
+        `commands_post:`,
+        ...patch.commands_post.map((c) => `  - "${c}"`),
+        '',
+    ].join('\n');
+    if (existed) {
+        try {
+            backupFileBeforeWrite(filePath, original);
+        }
+        catch {
+            /* not critical */
+        }
+    }
+    else {
+        mkdirSync(dirname(filePath), { recursive: true });
+    }
+    const next = `${header}${appendedBlock}`;
+    writeFileSync(filePath, next, { encoding: 'utf-8', mode: 0o644 });
+    return {
+        action: existed ? 'merged' : 'created',
+        details: `appended commands_pre/post (${patch.commands_pre.length}/${patch.commands_post.length})`,
+    };
+}
+export function initHarness(opts) {
+    const paths = pathsFor(opts.harness, opts.cwd);
+    const caps = capabilitiesFor(opts.harness);
+    const warnings = [];
+    // 1. LLM priming
+    const llm = writePrimingBlock(paths.primingFile, opts.lang ?? 'auto');
+    // 2. harness 层
+    let harnessConfig;
+    if (opts.llmOnly || !paths.harnessConfigFile || !caps.preToolUseHook) {
+        harnessConfig = {
+            file: paths.harnessConfigFile,
+            action: !paths.harnessConfigFile
+                ? 'skipped-no-config-file'
+                : 'skipped-no-hook-support',
+            details: caps.fallback,
+        };
+        if (caps.fallback)
+            warnings.push(caps.fallback);
+    }
+    else {
+        try {
+            if (opts.harness === 'claude-code') {
+                const r = mergeClaudeSettings(paths.harnessConfigFile, claudeSettingsPatch());
+                harnessConfig = { file: paths.harnessConfigFile, action: r.action, details: r.details };
+            }
+            else if (opts.harness === 'aider') {
+                const r = mergeAiderConfig(paths.harnessConfigFile, aiderConfigPatch());
+                harnessConfig = { file: paths.harnessConfigFile, action: r.action, details: r.details };
+            }
+            else {
+                harnessConfig = {
+                    file: paths.harnessConfigFile,
+                    action: 'skipped-no-hook-support',
+                    details: `${opts.harness} PreToolUse hook not yet implemented`,
+                };
+                warnings.push(harnessConfig.details);
+            }
+        }
+        catch (err) {
+            if (err instanceof HarnessWriterError) {
+                harnessConfig = {
+                    file: paths.harnessConfigFile,
+                    action: 'skipped-no-hook-support',
+                    details: `${err.code}: ${err.message}`,
+                };
+                warnings.push(err.message);
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    return {
+        harness: opts.harness,
+        paths,
+        llm_priming: {
+            file: paths.primingFile,
+            action: llm.action,
+        },
+        harness_config: harnessConfig,
+        warnings,
+    };
+}
+//# sourceMappingURL=writers.js.map

package/dist/harness/writers.js.map

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