@skillfm/local 2.7.4 → 2.7.6

package/dist/agent-forcing/forcing-rules.d.ts

@@ -0,0 +1,27 @@
+export interface ForcingGuideOptions {
+    /** Sidecar URL (e.g. http://127.0.0.1:19821) */
+    sidecar_url?: string;
+    /** 包版本 (写入 guide 让用户知道哪个版本注入的) */
+    version?: string;
+}
+/**
+ * 主 forcing guide markdown — 用于 OpenClaw / Claude Code / Cursor / Codex 注入.
+ * 双语 (中英) — 跟用户语言无关都覆盖.
+ */
+export declare function renderForcingGuide(opts?: ForcingGuideOptions): string;
+/**
+ * 给已存在 markdown 文件 (如 Claude CLAUDE.md) 用的 — 自动 detect 并替换/append marker block.
+ *
+ * 输入: 现有 markdown 文件内容
+ * 输出: 含 SkillFM marker block 的新内容 (替换旧块 / 或 append 新块)
+ */
+export declare function injectOrReplaceBlock(existingContent: string, opts?: ForcingGuideOptions): string;
+/**
+ * 移除已注入的 SkillFM block (uninstall 用)
+ */
+export declare function removeBlock(existingContent: string): string;
+/**
+ * 检测一个文件是否已含 SkillFM block
+ */
+export declare function hasMarkerBlock(content: string): boolean;
+//# sourceMappingURL=forcing-rules.d.ts.map

package/dist/agent-forcing/forcing-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forcing-rules.d.ts","sourceRoot":"","sources":["../../src/agent-forcing/forcing-rules.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,mBAAwB,GAAG,MAAM,CAiDzE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,GAAE,mBAAwB,GAAG,MAAM,CAkBpG;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD"}

package/dist/agent-forcing/forcing-rules.js

@@ -0,0 +1,98 @@
+// sdk/skillfm-local/src/agent-forcing/forcing-rules.ts
+//
+// SkillFM Agent Forcing Guide — 真注入 system prompt 的强 forcing rule.
+// 文案直接 inject 进 workspace files (如 OpenClaw AGENTS.md / Claude CLAUDE.md).
+import { SKILLFM_MARKER_START, SKILLFM_MARKER_END } from './types.js';
+const PACKAGE_VERSION = '__INJECT_VERSION__'; // 由 build 时 / runtime 替换
+/**
+ * 主 forcing guide markdown — 用于 OpenClaw / Claude Code / Cursor / Codex 注入.
+ * 双语 (中英) — 跟用户语言无关都覆盖.
+ */
+export function renderForcingGuide(opts = {}) {
+    const sidecar = opts.sidecar_url ?? 'http://127.0.0.1:19821';
+    const ver = opts.version ?? PACKAGE_VERSION;
+    return `${SKILLFM_MARKER_START}
+
+# SkillFM — Agent Forcing Rules (auto-injected by skillfm-local v${ver})
+
+> 这是 SkillFM 写入的 agent 行为强约束. 当前 sidecar: ${sidecar}
+> 不要手动删 — 卸载 SkillFM 时跑 \`npx @skillfm/local uninstall\` 自动清.
+
+## 中文规则 — 强制必读
+
+当用户提到以下任何关键词,**必须先调对应的 SkillFM MCP tool**,**禁止用 exec/curl/bash 命令绕过**:
+
+| 用户说什么 | 必调 MCP tool | 禁忌行为 |
+|---|---|---|
+| SkillFM / 体检 / 我家 AI 状态 / 健康度 | \`skillfm_checkup\` | ❌ 不要 \`curl /status\` 自己拼; ❌ 不要凭空说"健康度 67" |
+| 我用了多少 token / 花了多少钱 / 哪能省 | \`skillfm_show_my_usage({window: 'today'\\|'week'\\|'month'})\` | ❌ 不要凭空算用量 |
+| 给 OpenAI / Anthropic / DeepSeek API key | \`skillfm_explain_provider_key({provider})\` 然后 \`skillfm_save_credential\` | ❌ 不要直接问用户要 key 不解释; ❌ 不要凭空说"你需要 billing-only key" |
+| 装 / 接入 / 配置 SkillFM | \`skillfm_setup_gateway({dry_run: true})\` 先看检测; 用户 OK 后 \`{dry_run: false}\` | ❌ 不要直接改用户 IDE config 不问; ❌ 不要凭空写"激活码 XXXXXXXX" |
+| 看完整体检 / 5 维度详情 | \`skillfm_checkup({full: true})\` | 同上 |
+
+**Tool 输出处理规则**:
+- 所有 SkillFM MCP tool 返回的 \`rendered\` 字段是**预渲染好的用户面 UX**,**直接显示给用户**, 不要修改 / 概括 / 加自己的话.
+- 如果 tool 返 \`{ok:false, error}\`, 把 \`error.message\` 真显示给用户, 不要装作成功.
+
+**激活流程禁忌**:
+- 用户说"接入 SkillFM" → 真执行 \`POST ${sidecar}/activate/start\` 拿真 device code, **绝不凭空写 placeholder URL** 如 \`code=XXXXXXXX\`.
+- 真 URL 包含 device code 由 sidecar 返, 不是你猜的.
+
+---
+
+## English Rules — Mandatory
+
+When user mentions any of these keywords, **MUST call the corresponding SkillFM MCP tool**, **NEVER bypass with exec/curl/bash**:
+
+| User says | Call this MCP tool | Forbidden |
+|---|---|---|
+| SkillFM / checkup / my AI status / health score | \`skillfm_checkup\` | ❌ Don't curl /status; ❌ Don't fabricate score |
+| how much token / cost / where to save | \`skillfm_show_my_usage({window})\` | ❌ Don't fabricate usage |
+| give OpenAI / Anthropic key | \`skillfm_explain_provider_key({provider})\` then \`skillfm_save_credential\` | ❌ Don't ask for "billing-only key" without explaining via tool |
+| install / setup SkillFM | \`skillfm_setup_gateway({dry_run: true})\` first, then \`{dry_run: false}\` | ❌ Don't modify IDE config without asking |
+
+**Tool output handling**: SkillFM MCP tools return a pre-rendered \`rendered\` field — show it directly to user, don't paraphrase.
+
+**Activation flow**: User says "install SkillFM" → call sidecar \`POST ${sidecar}/activate/start\` to get real device code. **NEVER fabricate placeholder URLs like \`code=XXXXXXXX\`.**
+
+${SKILLFM_MARKER_END}`;
+}
+/**
+ * 给已存在 markdown 文件 (如 Claude CLAUDE.md) 用的 — 自动 detect 并替换/append marker block.
+ *
+ * 输入: 现有 markdown 文件内容
+ * 输出: 含 SkillFM marker block 的新内容 (替换旧块 / 或 append 新块)
+ */
+export function injectOrReplaceBlock(existingContent, opts = {}) {
+    const newBlock = renderForcingGuide(opts);
+    const startIdx = existingContent.indexOf(SKILLFM_MARKER_START);
+    const endIdx = existingContent.indexOf(SKILLFM_MARKER_END);
+    if (startIdx >= 0 && endIdx > startIdx) {
+        // 替换已有 block (升级版本 / 文案 update)
+        return (existingContent.slice(0, startIdx).trimEnd() +
+            '\n\n' +
+            newBlock +
+            '\n' +
+            existingContent.slice(endIdx + SKILLFM_MARKER_END.length).trimStart());
+    }
+    // Append (没 block, 加在末尾)
+    return existingContent.trimEnd() + '\n\n' + newBlock + '\n';
+}
+/**
+ * 移除已注入的 SkillFM block (uninstall 用)
+ */
+export function removeBlock(existingContent) {
+    const startIdx = existingContent.indexOf(SKILLFM_MARKER_START);
+    const endIdx = existingContent.indexOf(SKILLFM_MARKER_END);
+    if (startIdx < 0 || endIdx <= startIdx)
+        return existingContent;
+    return (existingContent.slice(0, startIdx).trimEnd() +
+        existingContent.slice(endIdx + SKILLFM_MARKER_END.length).trimStart());
+}
+/**
+ * 检测一个文件是否已含 SkillFM block
+ */
+export function hasMarkerBlock(content) {
+    return content.includes(SKILLFM_MARKER_START) && content.includes(SKILLFM_MARKER_END);
+}
+//# sourceMappingURL=forcing-rules.js.map

package/dist/agent-forcing/forcing-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forcing-rules.js","sourceRoot":"","sources":["../../src/agent-forcing/forcing-rules.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,mEAAmE;AACnE,2EAA2E;AAE3E,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEtE,MAAM,eAAe,GAAG,oBAAoB,CAAC,CAAC,yBAAyB;AASvE;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA4B,EAAE;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,IAAI,wBAAwB,CAAC;IAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC;IAE5C,OAAO,GAAG,oBAAoB;;mEAEmC,GAAG;;4CAE1B,OAAO;;;;;;;;;;;;;;;;;;;;iCAoBlB,OAAO;;;;;;;;;;;;;;;;;;yEAkBiC,OAAO;;EAE9E,kBAAkB,EAAE,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,eAAuB,EAAE,OAA4B,EAAE;IAC1F,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE3D,IAAI,QAAQ,IAAI,CAAC,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;QACvC,gCAAgC;QAChC,OAAO,CACL,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE;YAC5C,MAAM;YACN,QAAQ;YACR,IAAI;YACJ,eAAe,CAAC,KAAK,CAAC,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CACtE,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,OAAO,eAAe,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,eAAuB;IACjD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3D,IAAI,QAAQ,GAAG,CAAC,IAAI,MAAM,IAAI,QAAQ;QAAE,OAAO,eAAe,CAAC;IAC/D,OAAO,CACL,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE;QAC5C,eAAe,CAAC,KAAK,CAAC,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CACtE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AACxF,CAAC"}

package/dist/agent-forcing/index.d.ts

@@ -0,0 +1,5 @@
+export type { HarnessId, HarnessDetection, ForcingInjectResult, } from './types.js';
+export { SKILLFM_MARKER_START, SKILLFM_MARKER_END } from './types.js';
+export { renderForcingGuide, injectOrReplaceBlock, removeBlock, hasMarkerBlock, } from './forcing-rules.js';
+export { detectOpenClaw, injectOpenClaw, detectClaudeCode, injectClaudeCode, detectCursor, injectCursor, detectCodex, injectCodex, detectContinue, detectAllHarnesses, injectAllDetected, removeAllInjections, } from './injectors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent-forcing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-forcing/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/agent-forcing/index.js

@@ -0,0 +1,6 @@
+// sdk/skillfm-local/src/agent-forcing/index.ts
+// Agent Forcing Adapter — public API.
+export { SKILLFM_MARKER_START, SKILLFM_MARKER_END } from './types.js';
+export { renderForcingGuide, injectOrReplaceBlock, removeBlock, hasMarkerBlock, } from './forcing-rules.js';
+export { detectOpenClaw, injectOpenClaw, detectClaudeCode, injectClaudeCode, detectCursor, injectCursor, detectCodex, injectCodex, detectContinue, detectAllHarnesses, injectAllDetected, removeAllInjections, } from './injectors.js';
+//# sourceMappingURL=index.js.map

package/dist/agent-forcing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-forcing/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,sCAAsC;AAOtC,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/agent-forcing/injectors.d.ts

@@ -0,0 +1,29 @@
+import type { HarnessDetection, ForcingInjectResult } from './types.js';
+export declare function detectOpenClaw(): Promise<HarnessDetection>;
+export declare function injectOpenClaw(opts?: {
+    sidecar_url?: string;
+    version?: string;
+}): Promise<ForcingInjectResult>;
+export declare function detectClaudeCode(): Promise<HarnessDetection>;
+export declare function injectClaudeCode(opts?: {
+    sidecar_url?: string;
+    version?: string;
+}): Promise<ForcingInjectResult>;
+export declare function detectCursor(): Promise<HarnessDetection>;
+export declare function injectCursor(opts?: {
+    sidecar_url?: string;
+    version?: string;
+}): Promise<ForcingInjectResult>;
+export declare function detectCodex(): Promise<HarnessDetection>;
+export declare function injectCodex(opts?: {
+    sidecar_url?: string;
+    version?: string;
+}): Promise<ForcingInjectResult>;
+export declare function detectContinue(): Promise<HarnessDetection>;
+export declare function detectAllHarnesses(): Promise<HarnessDetection[]>;
+export declare function injectAllDetected(opts?: {
+    sidecar_url?: string;
+    version?: string;
+}): Promise<ForcingInjectResult[]>;
+export declare function removeAllInjections(): Promise<ForcingInjectResult[]>;
+//# sourceMappingURL=injectors.d.ts.map

package/dist/agent-forcing/injectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectors.d.ts","sourceRoot":"","sources":["../../src/agent-forcing/injectors.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAa,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAwBnF,wBAAsB,cAAc,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAYhE;AAED,wBAAsB,cAAc,CAAC,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAoBxH;AAMD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAYlE;AAED,wBAAsB,gBAAgB,CAAC,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAwB1H;AAMD,wBAAsB,YAAY,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAgB9D;AAED,wBAAsB,YAAY,CAAC,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAwBtH;AAKD,wBAAsB,WAAW,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAY7D;AAED,wBAAsB,WAAW,CAAC,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAwBrH;AAGD,wBAAsB,cAAc,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAGhE;AAGD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAQtE;AAGD,wBAAsB,iBAAiB,CAAC,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAY7H;AAGD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA2B1E"}

package/dist/agent-forcing/injectors.js

@@ -0,0 +1,255 @@
+// sdk/skillfm-local/src/agent-forcing/injectors.ts
+//
+// Per-harness 注入实现 — detect + inject + revert.
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+import { renderForcingGuide, injectOrReplaceBlock, removeBlock, hasMarkerBlock, } from './forcing-rules.js';
+const BACKUP_BASE = path.join(homedir(), '.skillfm', 'agent-forcing-backup');
+async function backupFile(filePath) {
+    const ts = new Date().toISOString().replace(/[:.]/g, '-');
+    const dir = path.join(BACKUP_BASE, ts);
+    await fs.promises.mkdir(dir, { recursive: true, mode: 0o700 });
+    const name = path.basename(filePath);
+    const backupPath = path.join(dir, name);
+    await fs.promises.copyFile(filePath, backupPath);
+    return backupPath;
+}
+// ── OpenClaw ────────────────────────────────────────────────────────
+// 路径: ~/.openclaw/workspace/SKILLFM-AGENT-GUIDE.md (新建独立文件)
+// OpenClaw 自动 inject workspace 所有 .md 到 system_prompt (我们 trace 验过 48KB)
+export async function detectOpenClaw() {
+    const workspaceDir = path.join(homedir(), '.openclaw', 'workspace');
+    const injectPath = path.join(workspaceDir, 'SKILLFM-AGENT-GUIDE.md');
+    const detected = fs.existsSync(workspaceDir);
+    let already = false;
+    if (detected && fs.existsSync(injectPath)) {
+        try {
+            const c = await fs.promises.readFile(injectPath, 'utf-8');
+            already = hasMarkerBlock(c);
+        }
+        catch { }
+    }
+    return { harness: 'openclaw', detected, inject_path: detected ? injectPath : undefined, already_injected: already };
+}
+export async function injectOpenClaw(opts = {}) {
+    const det = await detectOpenClaw();
+    if (!det.detected) {
+        return { harness: 'openclaw', applied: false, error: 'OpenClaw workspace not found (~/.openclaw/workspace)' };
+    }
+    const filePath = det.inject_path;
+    let backup_path;
+    if (fs.existsSync(filePath)) {
+        backup_path = await backupFile(filePath);
+    }
+    const content = renderForcingGuide(opts);
+    await fs.promises.writeFile(filePath, content, 'utf-8');
+    return {
+        harness: 'openclaw',
+        applied: true,
+        inject_path: filePath,
+        backup_path,
+        revert_command: backup_path ? `cp "${backup_path}" "${filePath}"` : `rm "${filePath}"`,
+        bytes_injected: Buffer.byteLength(content, 'utf-8'),
+    };
+}
+// ── Claude Code ─────────────────────────────────────────────────────
+// 路径: ~/.claude/CLAUDE.md (user-level memory, Claude Code 必读)
+// 注入: marker block append/replace 进现有 CLAUDE.md
+export async function detectClaudeCode() {
+    const claudeDir = path.join(homedir(), '.claude');
+    const injectPath = path.join(claudeDir, 'CLAUDE.md');
+    const detected = fs.existsSync(claudeDir);
+    let already = false;
+    if (detected && fs.existsSync(injectPath)) {
+        try {
+            const c = await fs.promises.readFile(injectPath, 'utf-8');
+            already = hasMarkerBlock(c);
+        }
+        catch { }
+    }
+    return { harness: 'claude-code', detected, inject_path: detected ? injectPath : undefined, already_injected: already };
+}
+export async function injectClaudeCode(opts = {}) {
+    const det = await detectClaudeCode();
+    if (!det.detected) {
+        return { harness: 'claude-code', applied: false, error: 'Claude Code not detected (~/.claude not found)' };
+    }
+    const filePath = det.inject_path;
+    let existingContent = '';
+    let backup_path;
+    if (fs.existsSync(filePath)) {
+        backup_path = await backupFile(filePath);
+        existingContent = await fs.promises.readFile(filePath, 'utf-8');
+    }
+    else {
+        existingContent = '# Claude Code Memory\n\n';
+    }
+    const newContent = injectOrReplaceBlock(existingContent, opts);
+    await fs.promises.writeFile(filePath, newContent, 'utf-8');
+    return {
+        harness: 'claude-code',
+        applied: true,
+        inject_path: filePath,
+        backup_path,
+        revert_command: backup_path ? `cp "${backup_path}" "${filePath}"` : `rm "${filePath}"`,
+        bytes_injected: Buffer.byteLength(newContent, 'utf-8') - Buffer.byteLength(existingContent, 'utf-8'),
+    };
+}
+// ── Cursor ──────────────────────────────────────────────────────────
+// 路径: 当前 cwd 的 .cursor/rules/skillfm.md (project-level)
+// Cursor 自动注入 .cursor/rules/*.md 到 agent system prompt
+export async function detectCursor() {
+    // Mac: ~/Library/Application Support/Cursor/ — 检测 Cursor 装了
+    const cursorAppDir = path.join(homedir(), 'Library', 'Application Support', 'Cursor');
+    const detected = fs.existsSync(cursorAppDir);
+    // 注入路径: 用户当前 cwd 下 .cursor/rules/skillfm.md
+    // 但 sidecar cmdStart 时 cwd 可能不是 user's project — 这里只能 surface 提示
+    const cwdRules = path.join(process.cwd(), '.cursor', 'rules');
+    const injectPath = path.join(cwdRules, 'skillfm.md');
+    let already = false;
+    if (detected && fs.existsSync(injectPath)) {
+        try {
+            const c = await fs.promises.readFile(injectPath, 'utf-8');
+            already = hasMarkerBlock(c);
+        }
+        catch { }
+    }
+    return { harness: 'cursor', detected, inject_path: detected ? injectPath : undefined, already_injected: already };
+}
+export async function injectCursor(opts = {}) {
+    const det = await detectCursor();
+    if (!det.detected) {
+        return { harness: 'cursor', applied: false, error: 'Cursor not detected' };
+    }
+    const filePath = det.inject_path;
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        await fs.promises.mkdir(dir, { recursive: true });
+    }
+    let backup_path;
+    if (fs.existsSync(filePath)) {
+        backup_path = await backupFile(filePath);
+    }
+    const content = renderForcingGuide(opts);
+    await fs.promises.writeFile(filePath, content, 'utf-8');
+    return {
+        harness: 'cursor',
+        applied: true,
+        inject_path: filePath,
+        backup_path,
+        revert_command: backup_path ? `cp "${backup_path}" "${filePath}"` : `rm "${filePath}"`,
+        bytes_injected: Buffer.byteLength(content, 'utf-8'),
+    };
+}
+// ── Codex ──────────────────────────────────────────────────────────
+// 路径: ~/.codex/AGENTS.md (marker block)
+export async function detectCodex() {
+    const codexDir = path.join(homedir(), '.codex');
+    const injectPath = path.join(codexDir, 'AGENTS.md');
+    const detected = fs.existsSync(codexDir);
+    let already = false;
+    if (detected && fs.existsSync(injectPath)) {
+        try {
+            const c = await fs.promises.readFile(injectPath, 'utf-8');
+            already = hasMarkerBlock(c);
+        }
+        catch { }
+    }
+    return { harness: 'codex', detected, inject_path: detected ? injectPath : undefined, already_injected: already };
+}
+export async function injectCodex(opts = {}) {
+    const det = await detectCodex();
+    if (!det.detected) {
+        return { harness: 'codex', applied: false, error: 'Codex not detected (~/.codex not found)' };
+    }
+    const filePath = det.inject_path;
+    let existing = '';
+    let backup_path;
+    if (fs.existsSync(filePath)) {
+        backup_path = await backupFile(filePath);
+        existing = await fs.promises.readFile(filePath, 'utf-8');
+    }
+    else {
+        existing = '# Codex AGENTS.md\n\n';
+    }
+    const newContent = injectOrReplaceBlock(existing, opts);
+    await fs.promises.writeFile(filePath, newContent, 'utf-8');
+    return {
+        harness: 'codex',
+        applied: true,
+        inject_path: filePath,
+        backup_path,
+        revert_command: backup_path ? `cp "${backup_path}" "${filePath}"` : `rm "${filePath}"`,
+        bytes_injected: Buffer.byteLength(newContent, 'utf-8') - Buffer.byteLength(existing, 'utf-8'),
+    };
+}
+// ── Continue (config.json systemMessage) — MVP 暂用 stub, 后续真做 ──
+export async function detectContinue() {
+    const cfgPath = path.join(homedir(), '.continue', 'config.json');
+    return { harness: 'continue', detected: fs.existsSync(cfgPath), inject_path: cfgPath, already_injected: false };
+}
+// ── Detect 全部 ──
+export async function detectAllHarnesses() {
+    return Promise.all([
+        detectOpenClaw(),
+        detectClaudeCode(),
+        detectCursor(),
+        detectCodex(),
+        detectContinue(),
+    ]);
+}
+// ── Inject 全部检测到的 ──
+export async function injectAllDetected(opts = {}) {
+    const detections = await detectAllHarnesses();
+    const results = [];
+    for (const d of detections) {
+        if (!d.detected)
+            continue;
+        if (d.harness === 'openclaw')
+            results.push(await injectOpenClaw(opts));
+        else if (d.harness === 'claude-code')
+            results.push(await injectClaudeCode(opts));
+        else if (d.harness === 'cursor')
+            results.push(await injectCursor(opts));
+        else if (d.harness === 'codex')
+            results.push(await injectCodex(opts));
+        // continue MVP skip
+    }
+    return results;
+}
+// ── Uninstall: 移除所有注入 ──
+export async function removeAllInjections() {
+    const detections = await detectAllHarnesses();
+    const results = [];
+    for (const d of detections) {
+        if (!d.inject_path)
+            continue;
+        if (!fs.existsSync(d.inject_path))
+            continue;
+        try {
+            const content = await fs.promises.readFile(d.inject_path, 'utf-8');
+            if (!hasMarkerBlock(content))
+                continue;
+            const cleaned = removeBlock(content);
+            // 如果 cleaned 是空 / 只剩默认 header → 删文件 (适用 OpenClaw / Cursor 独立文件)
+            if (d.harness === 'openclaw' || d.harness === 'cursor') {
+                await fs.promises.unlink(d.inject_path);
+            }
+            else {
+                await fs.promises.writeFile(d.inject_path, cleaned, 'utf-8');
+            }
+            results.push({
+                harness: d.harness,
+                applied: true,
+                inject_path: d.inject_path,
+                bytes_injected: -(Buffer.byteLength(content, 'utf-8') - Buffer.byteLength(cleaned, 'utf-8')),
+            });
+        }
+        catch (e) {
+            results.push({ harness: d.harness, applied: false, error: e.message });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=injectors.js.map

package/dist/agent-forcing/injectors.js.map

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

package/dist/agent-forcing/types.d.ts

@@ -0,0 +1,26 @@
+export type HarnessId = 'openclaw' | 'claude-code' | 'cursor' | 'codex' | 'continue';
+export interface HarnessDetection {
+    harness: HarnessId;
+    /** 是否检测到这个 harness 已装 */
+    detected: boolean;
+    /** 注入文件真路径 (e.g. ~/.openclaw/workspace/SKILLFM-AGENT-GUIDE.md) */
+    inject_path?: string;
+    /** SkillFM 块当前是否已注入 (检查 marker) */
+    already_injected: boolean;
+}
+export interface ForcingInjectResult {
+    harness: HarnessId;
+    applied: boolean;
+    inject_path?: string;
+    /** Backup 路径 (如果改了已存在文件) */
+    backup_path?: string;
+    /** Revert 命令 1 行 */
+    revert_command?: string;
+    error?: string;
+    /** 注入的字符数 */
+    bytes_injected?: number;
+}
+/** SkillFM marker 块标记 — 用来识别已注入 + revert 时定位 */
+export declare const SKILLFM_MARKER_START = "<!-- SKILLFM-AGENT-GUIDE BEGIN (auto-injected, do not delete) -->";
+export declare const SKILLFM_MARKER_END = "<!-- SKILLFM-AGENT-GUIDE END -->";
+//# sourceMappingURL=types.d.ts.map

package/dist/agent-forcing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent-forcing/types.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,aAAa,GACb,QAAQ,GACR,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,SAAS,CAAC;IACnB,yBAAyB;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gDAAgD;AAChD,eAAO,MAAM,oBAAoB,sEAAsE,CAAC;AACxG,eAAO,MAAM,kBAAkB,qCAAqC,CAAC"}

package/dist/agent-forcing/types.js

@@ -0,0 +1,21 @@
+// sdk/skillfm-local/src/agent-forcing/types.ts
+//
+// Agent Forcing Adapter — install 时主动检测各 harness workspace files +
+// 注入 SKILLFM-AGENT-GUIDE 强 forcing rule 进 system prompt.
+//
+// 真问题 (Eric 反馈, turn 4 真测):
+//   - MiniMax-M2.7 instruction following 弱, 倾向 generic exec, 不调 SkillFM MCP tool
+//   - MCP tool description 写多强都输 system prompt 注入 (训练数据 bias)
+//   - 真解 = 各 harness workspace files 加 SkillFM forcing rule, agent 必看
+//
+// 各 harness 真注入路径 (调研验证):
+//   OpenClaw: ~/.openclaw/workspace/SKILLFM-AGENT-GUIDE.md
+//   Claude Code: ~/.claude/CLAUDE.md (user-level, marker block)
+//   Cursor: .cursor/rules/skillfm.md (project-level)
+//   Codex: ~/.codex/AGENTS.md (marker block)
+//   Continue: continue.config.json systemMessage (后续)
+//   Aider: ❌ 没 system prompt 注入机制 (用 CLI fallback)
+/** SkillFM marker 块标记 — 用来识别已注入 + revert 时定位 */
+export const SKILLFM_MARKER_START = '<!-- SKILLFM-AGENT-GUIDE BEGIN (auto-injected, do not delete) -->';
+export const SKILLFM_MARKER_END = '<!-- SKILLFM-AGENT-GUIDE END -->';
+//# sourceMappingURL=types.js.map

package/dist/agent-forcing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent-forcing/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,mEAAmE;AACnE,yDAAyD;AACzD,EAAE;AACF,4BAA4B;AAC5B,iFAAiF;AACjF,8DAA8D;AAC9D,sEAAsE;AACtE,EAAE;AACF,0BAA0B;AAC1B,2DAA2D;AAC3D,gEAAgE;AAChE,qDAAqD;AACrD,6CAA6C;AAC7C,sDAAsD;AACtD,mDAAmD;AAgCnD,gDAAgD;AAChD,MAAM,CAAC,MAAM,oBAAoB,GAAG,mEAAmE,CAAC;AACxG,MAAM,CAAC,MAAM,kBAAkB,GAAG,kCAAkC,CAAC"}

package/dist/checkup/dimension-3-files.d.ts

@@ -5,12 +5,26 @@ interface FileGroup {
     total_bytes: number;
     age_days_min: number;
 }
+interface CleanupHistoryEntry {
+    timestamp: string;
+    bytes_freed: number;
+    files_moved: number;
+}
+declare function appendCleanupHistory(entry: CleanupHistoryEntry): Promise<void>;
 /**
- * 跑一次 file 体检 — 返 DimensionStatus + 各 group 详情
+ * 跑一次 file 体检 — 返 DimensionStatus + 各 group 详情 + 累计 history
  */
 export declare function checkDimensionFiles(): Promise<DimensionStatus & {
     groups: FileGroup[];
+    cumulative_this_month: {
+        bytes: number;
+        files: number;
+    };
 }>;
+/**
+ * Export for cleanup execution to record history
+ */
+export { appendCleanupHistory };
 /**
  * 一键清 — 删 group 列出的文件 (移到 ~/.skillfm/cleanup-archive/<timestamp>/ 不真删, 7 天后真清)
  * 返 删了多少 bytes + 多少 file
@@ -19,5 +33,4 @@ export declare function executeFileCleanup(groups: FileGroup[]): Promise<{
     bytes_freed: number;
     files_moved: number;
 }>;
-export {};
 //# sourceMappingURL=dimension-3-files.d.ts.map

package/dist/checkup/dimension-3-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dimension-3-files.d.ts","sourceRoot":"","sources":["../../src/checkup/dimension-3-files.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,YAAY,CAAC;AAErE,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AA4ED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,eAAe,GAAG;IAAE,MAAM,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC,CAuD9F;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAuBnH"}
+{"version":3,"file":"dimension-3-files.d.ts","sourceRoot":"","sources":["../../src/checkup/dimension-3-files.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,YAAY,CAAC;AAErE,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AA4HD,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AA0BD,iBAAe,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7E;AASD;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,eAAe,GAAG;IAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,qBAAqB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,CAoEvJ;AAED;;GAEG;AACH,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCnH"}