openfeel 1.1.0 → 1.1.2

package/dist/core/setup.js

@@ -0,0 +1,103 @@
+/**
+ * setup 命令核心模块（v1.1.1）
+ * 纯全局部署：全局 AGENTS.md + 9 agent + 17 skill + 全局平台适配器配置文件（opencode.jsonc）。
+ * 不建立项目 .openfeel/；复用 deployGlobalAsset（受管区三态，幂等可重跑）。
+ */
+import { mkdirSync, existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { listAgentIds, loadAgentTemplate, loadTemplate } from './template-loader.js';
+import { loadGlobalUpdateState, saveGlobalUpdateState, createGlobalUpdateState, updateFileHash } from './update-state.js';
+import { deployGlobalAsset, SKILL_DEFINITIONS } from './update.js';
+import { appendUpdateInfo } from './update-infos.js';
+import { backupFileBeforeWrite, notifyBackupIfTTY, BackupError } from './backup.js';
+import { mergeGlobalOpencodeJsonc } from './opencode-config.js';
+import { t } from './i18n.js';
+import { getGlobalAgentsMdPath, getGlobalAgentsDir, getGlobalSkillsDir, getGlobalOpencodeJsoncPath } from './global-paths.js';
+import { atomicWriteFileSync } from './fs/atomic-write.js';
+import { readJsoncFile } from './fs/safe-read.js';
+import { withFileLock, globalLockPath } from './fs/file-lock.js';
+/** 纯全局部署（首次全量，幂等）；不建立项目 .openfeel/ */
+export function setupGlobalFramework(lang = 'zh-CN') {
+    const created = [];
+    const updated = [];
+    const skipped = [];
+    const appended = [];
+    const push = (action, path) => {
+        if (action === 'created')
+            created.push(path);
+        else if (action === 'updated')
+            updated.push(path);
+        else if (action === 'skipped')
+            skipped.push(path);
+        else
+            appended.push(path);
+    };
+    const globalState = loadGlobalUpdateState() ?? createGlobalUpdateState({});
+    // 1. 全局 AGENTS.md（框架约束唯一权威）
+    push(deployGlobalAsset(getGlobalAgentsMdPath(), loadTemplate(lang, 'agents-md'), globalState, 'setup'), getGlobalAgentsMdPath());
+    // 2. 9 agent → 全局 agents 目录
+    const agentsDir = getGlobalAgentsDir();
+    mkdirSync(agentsDir, { recursive: true });
+    for (const id of listAgentIds(lang)) {
+        const p = join(agentsDir, `${id}.md`);
+        push(deployGlobalAsset(p, loadAgentTemplate(lang, id), globalState, 'setup'), p);
+    }
+    // 3. 17 skill → 全局 skills 目录
+    const skillsDir = getGlobalSkillsDir();
+    mkdirSync(skillsDir, { recursive: true });
+    for (const [name, content] of Object.entries(SKILL_DEFINITIONS)) {
+        mkdirSync(join(skillsDir, name), { recursive: true });
+        const p = join(skillsDir, name, 'SKILL.md');
+        push(deployGlobalAsset(p, content, globalState, 'setup'), p);
+    }
+    // 4. 全局平台适配器配置文件（opencode.jsonc）：深度合并（保留用户字段），加全局锁 + 原子写
+    const jsoncPath = getGlobalOpencodeJsoncPath();
+    try {
+        // 写前备份（B3）：备份须在 jsonc 锁之外（之前）完成，避免 backup 锁与 jsonc 锁嵌套
+        const jsoncBackup = backupFileBeforeWrite(jsoncPath, { command: 'setup' });
+        if (jsoncBackup) {
+            appendUpdateInfo('backed', { absolutePath: jsoncPath, backupRel: jsoncBackup.backupRel, command: 'setup' });
+            notifyBackupIfTTY(jsoncBackup.backupRel);
+        }
+        const merged = withFileLock(globalLockPath('global-opencode-jsonc'), () => {
+            // 安全读取（T50）：目录占位/不可读 → null，跳过合并与写入，按空配置继续
+            const current = readJsoncFile(jsoncPath);
+            if (current === null) {
+                return null;
+            }
+            let out;
+            try {
+                out = mergeGlobalOpencodeJsonc(current);
+            }
+            catch (err) {
+                // 解析失败时保留原文件，避免破坏用户配置
+                console.warn(t('setup.globalJsoncParseSkipTmpl', lang, { err: err.message }));
+                out = current;
+            }
+            atomicWriteFileSync(jsoncPath, out);
+            return out;
+        });
+        if (merged !== null) {
+            updateFileHash(globalState, jsoncPath, merged);
+        }
+    }
+    catch (err) {
+        if (err instanceof BackupError) {
+            // 备份失败（REV-011-A）：跳过全局 jsonc 写入、记 anomaly、继续其余步骤（对齐 B3 幂等语义）
+            appendUpdateInfo('anomaly', { absolutePath: jsoncPath, note: 'backup_failed' });
+            console.warn(t('setup.globalJsoncWriteSkipTmpl', lang, { err: err.message }));
+        }
+        else {
+            throw err; // 非备份错误照旧上抛（锁超时等不回退）
+        }
+    }
+    // 5. 写盘全局 state + 记录已部署 hash
+    for (const p of [...created, ...updated, ...appended]) {
+        if (existsSync(p))
+            updateFileHash(globalState, p, readFileSync(p, 'utf-8'));
+    }
+    globalState.last_update = new Date().toISOString();
+    saveGlobalUpdateState(globalState);
+    return { created, updated, skipped, appended };
+}
+//# sourceMappingURL=setup.js.map

package/dist/core/setup.js.map

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

package/dist/core/template-loader.d.ts

@@ -14,11 +14,10 @@ export declare function loadAgentTemplate(lang: string, agentId: string): string
  * 指定语言不存在时回退到 zh-CN。
  */
 export declare function listAgentIds(lang: string): string[];
-/** 加载通用模板（core-instructions / agents-md） */
-export type TemplateName = 'core-instructions' | 'agents-md';
+/** 加载通用模板（agents-md，即全局 AGENTS.md 内容） */
+export type TemplateName = 'agents-md';
 export declare function loadTemplate(lang: string, templateName: TemplateName): string;
 export declare const AGENTS_MD_TEMPLATE: string;
-export declare const CORE_INSTRUCTIONS_TEMPLATE_B64: string;
 /**
  * 加载 opencode Agent 模板（用于部署 .opencode/agents/）
  * 指定语言不存在时回退到 zh-CN
@@ -29,8 +28,8 @@ export declare function loadOpencodeAgentTemplate(lang: string, agentId: string)
  */
 export declare function loadOpencodeSkillTemplate(skillName: string): string;
 /**
- * 加载 opencode 配置类模板（instructions / adapter）
- * instructions 与 adapter 以 Base64 存储（与 core-instructions 一致），加载时解码
+ * 加载 opencode 配置类模板（adapter）
+ * adapter 以 Base64 存储（与旧 instructions 一致），加载时解码
  * 指定语言不存在时回退到 zh-CN
  */
 export declare function loadOpencodeConfigTemplate(lang: string, configName: string): string;

package/dist/core/template-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-loader.d.ts","sourceRoot":"","sources":["../../src/core/template-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAo4FH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAWvE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGnD;AAED,4CAA4C;AAC5C,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,WAAW,CAAC;AAE7D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,MAAM,CAe7E;AAwrHD,eAAO,MAAM,kBAAkB,EAAE,MAAqC,CAAC;AACvE,eAAO,MAAM,8BAA8B,EAAE,MAA6C,CAAC;AAE3F;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAO/E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAWnF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAG3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAEjD"}
+{"version":3,"file":"template-loader.d.ts","sourceRoot":"","sources":["../../src/core/template-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+pHH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAWvE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGnD;AAED,yCAAyC;AACzC,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC;AAEvC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,MAAM,CAS7E;AA28HD,eAAO,MAAM,kBAAkB,EAAE,MAAqC,CAAC;AAEvE;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAO/E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAWnF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAG3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAEjD"}