@skillfm/local 2.0.3 → 2.0.5

package/dist/skill-md/writer.js

@@ -0,0 +1,129 @@
+/**
+ * BSO M9 v0.3 — Layer 1: SKILL.md 写入器
+ *
+ * Refs:
+ *   - docs/prd/PRD-BSO-M9-HARNESS-HOOKS.md §3.2.2
+ *
+ * 写入策略：
+ *   - 项目级 ./SKILL.md：必写（所有 host 都拿到 priming）
+ *   - Anthropic Claude Code 用户级 ~/.claude/skills/skillfm-bso/SKILL.md：可选
+ *     （由 init flag --copy-to-user 触发，本里程碑只提供 hint）
+ *
+ * 已存在 ./SKILL.md：
+ *   - 内含 SKILLFM-SKILL-BEGIN/END → upgrade-safe replace
+ *   - 不含我们的标记 → backup 后 append（不覆盖用户已有 skill）
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+import { backupFileBeforeWrite } from '../soul-security.js';
+import { buildSkillMd, SKILL_MD_BEGIN, SKILL_MD_END, } from './template.js';
+export function writeProjectSkillMd(opts) {
+    const filePath = join(opts.cwd, 'SKILL.md');
+    const existed = existsSync(filePath);
+    const original = existed ? readFileSync(filePath, 'utf-8') : '';
+    const wrapped = buildSkillMd({ lang: opts.lang, withBoundaryMarkers: true });
+    // upgrade-safe 检查
+    const hasOurBlock = original.includes(SKILL_MD_BEGIN);
+    if (hasOurBlock && original.includes(wrapped.trimEnd())) {
+        return {
+            path: filePath,
+            action: 'already-present',
+            bytesWritten: 0,
+        };
+    }
+    // 文件不存在 → 直接写（无边界，因为整文件就是我们的）
+    if (!existed) {
+        mkdirSync(dirname(filePath), { recursive: true });
+        const standalone = buildSkillMd({ lang: opts.lang, withBoundaryMarkers: false });
+        writeFileSync(filePath, standalone, { encoding: 'utf-8', mode: 0o644 });
+        return {
+            path: filePath,
+            action: 'created',
+            bytesWritten: Buffer.byteLength(standalone, 'utf-8'),
+        };
+    }
+    // backup
+    let backupPath;
+    try {
+        const r = backupFileBeforeWrite(filePath, original);
+        backupPath = r.backup_path;
+    }
+    catch {
+        // not critical
+    }
+    let next;
+    let action;
+    if (hasOurBlock) {
+        // replace 旧 block
+        const startIdx = original.indexOf(SKILL_MD_BEGIN);
+        const endIdx = original.indexOf(SKILL_MD_END);
+        if (startIdx === -1 || endIdx === -1 || endIdx < startIdx) {
+            // 标记残缺 — 保守 append
+            next = `${original}${original.endsWith('\n') ? '' : '\n'}\n${wrapped}`;
+            action = 'appended';
+        }
+        else {
+            const before = original.slice(0, startIdx).replace(/\n+$/, '\n');
+            const after = original.slice(endIdx + SKILL_MD_END.length).replace(/^\n+/, '');
+            next = `${before}\n${wrapped}${after}`.replace(/\n{3,}/g, '\n\n');
+            action = 'replaced';
+        }
+    }
+    else {
+        // 用户已有 SKILL.md（自定义 skill）→ append 我们的 block 在尾部
+        next = `${original}${original.endsWith('\n') ? '' : '\n'}\n${wrapped}`;
+        action = 'appended';
+    }
+    writeFileSync(filePath, next, { encoding: 'utf-8', mode: 0o644 });
+    return {
+        path: filePath,
+        action,
+        bytesWritten: Buffer.byteLength(next, 'utf-8'),
+        backupPath,
+    };
+}
+// ============================================================================
+// 用户级 hint（不实际写，只返回路径让 init 决定是否问用户）
+// ============================================================================
+export function userScopeSkillMdPath() {
+    return join(homedir(), '.claude', 'skills', 'skillfm-bso', 'SKILL.md');
+}
+export function writeUserScopeSkillMd(lang) {
+    const filePath = userScopeSkillMdPath();
+    const standalone = buildSkillMd({ lang, withBoundaryMarkers: false });
+    const existed = existsSync(filePath);
+    if (existed) {
+        const original = readFileSync(filePath, 'utf-8');
+        if (original.trim() === standalone.trim()) {
+            return {
+                path: filePath,
+                action: 'already-present',
+                bytesWritten: 0,
+            };
+        }
+        let backupPath;
+        try {
+            const r = backupFileBeforeWrite(filePath, original);
+            backupPath = r.backup_path;
+        }
+        catch {
+            // ignore
+        }
+        writeFileSync(filePath, standalone, { encoding: 'utf-8', mode: 0o644 });
+        return {
+            path: filePath,
+            action: 'replaced',
+            bytesWritten: Buffer.byteLength(standalone, 'utf-8'),
+            backupPath,
+        };
+    }
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, standalone, { encoding: 'utf-8', mode: 0o644 });
+    return {
+        path: filePath,
+        action: 'created',
+        bytesWritten: Buffer.byteLength(standalone, 'utf-8'),
+    };
+}
+//# sourceMappingURL=writer.js.map

package/dist/skill-md/writer.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillfm/local",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "description": "SkillFM local sidecar — a tiny localhost HTTP proxy that lets any AI agent activate and run SkillFM skills in the current conversation without restarting its MCP runtime. Writes ~/.skillfm/local.json for service discovery.",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,7 +10,6 @@
     "README.md"
   ],
   "bin": {
-    "local": "dist/index.js",
     "skillfm-local": "dist/index.js",
     "skillfm-guard": "dist/guard/bin.js"
   },