openfeel 1.0.9 → 1.1.1

package/dist/core/fs/file-lock.js

@@ -0,0 +1,142 @@
+/**
+ * 跨进程文件锁（建议性 / advisory lock）
+ *
+ * 协议：
+ *   1. openSync(lockPath, 'wx') 独占创建成功 → 持锁，写入 {pid, time, token}；
+ *   2. 已存在（EEXIST）→ 指数退避重试，直至 timeoutMs；
+ *   3. 陈旧锁（mtime 年龄 > staleMs）→ 原子 rename 抢占后重试；
+ *   4. finally 释放：读回 token 校验归属，一致才 unlinkSync。
+ *
+ * TTL 定值依据（REV-006）：实测最长临界区 P99 ≈ 8.14ms（本机 NTFS），
+ *   staleMs = 3000ms ≈ 368×P99，且 staleMs < timeoutMs 保证崩溃残留可在等待窗口内被抢占。
+ *   心跳续期对同步临界区不可行（事件循环被阻塞），故采用静态大余量 TTL。
+ *
+ * 仅依赖 node:fs / node:path / node:crypto 与全局路径模块，不引入第三方依赖。
+ */
+import { closeSync, mkdirSync, openSync, readFileSync, renameSync, statSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { randomBytes } from 'node:crypto';
+import { getGlobalLockPath } from '../global-paths.js';
+/** 获取锁总超时（ms） */
+export const LOCK_TIMEOUT_MS_DEFAULT = 5000;
+/** 陈旧锁判定阈值（ms），依据实测临界区 P99 设定，见文件头说明 */
+export const LOCK_STALE_MS_DEFAULT = 3000;
+/** 退避初始间隔（ms） */
+export const LOCK_INITIAL_BACKOFF_MS_DEFAULT = 10;
+/** 退避上限（ms） */
+export const LOCK_MAX_BACKOFF_MS_DEFAULT = 500;
+/** 项目级锁文件路径：{projectPath}/.openfeel/tmp/locks/{name}.lock（S6） */
+export function projectLockPath(projectPath, name) {
+    return join(projectPath, '.openfeel', 'tmp', 'locks', `${name}.lock`);
+}
+/** 全局锁文件路径：~/.openfeel/locks/{name}.lock（跨项目全局写入用） */
+export function globalLockPath(name) {
+    // 委托 global-paths 作为全局路径唯一权威（N4 收口），签名不变供既有调用方复用
+    return getGlobalLockPath(name);
+}
+/** 同步睡眠（阻塞当前 JS 线程，不空转 CPU） */
+function sleepSync(ms) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+/** 读取锁文件内容；读取/解析失败返回 null */
+function readLockInfo(lockPath) {
+    try {
+        return JSON.parse(readFileSync(lockPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 尝试抢占陈旧锁：rename 到唯一名（原子，只有一个进程成功），随后 best-effort 删除。
+ * @returns 是否成功抢占（false 表示未过期 / 已被他人抢占 / Windows 占用）
+ */
+function tryReclaimStale(lockPath, staleMs) {
+    let mtimeMs;
+    try {
+        mtimeMs = statSync(lockPath).mtimeMs;
+    }
+    catch {
+        return false; // 锁已被释放/抢占
+    }
+    if (Date.now() - mtimeMs <= staleMs) {
+        return false; // 未过期
+    }
+    const stalePath = `${lockPath}.stale.${process.pid}.${randomBytes(4).toString('hex')}`;
+    try {
+        renameSync(lockPath, stalePath); // 原子抢占：并发者只有一个成功
+    }
+    catch {
+        // ENOENT（他人已抢占）/ EPERM、EBUSY（Windows 占用，持锁者仍活跃）→ 交回重试
+        return false;
+    }
+    try {
+        unlinkSync(stalePath);
+    }
+    catch {
+        // 清理失败忽略（残留为唯一名，不阻塞后续加锁）
+    }
+    return true;
+}
+/**
+ * 在文件锁保护下同步执行 fn。
+ *
+ * @param lockPath 锁文件绝对路径（用 projectLockPath / globalLockPath 构造）
+ * @param fn       临界区函数
+ * @param options  超时 / TTL / 退避配置
+ * @returns fn 的返回值
+ * @throws 超过 timeoutMs 仍无法获取锁时抛出；fn 自身抛错原样透传
+ */
+export function withFileLock(lockPath, fn, options = {}) {
+    const { timeoutMs = LOCK_TIMEOUT_MS_DEFAULT, staleMs = LOCK_STALE_MS_DEFAULT, initialBackoffMs = LOCK_INITIAL_BACKOFF_MS_DEFAULT, maxBackoffMs = LOCK_MAX_BACKOFF_MS_DEFAULT, } = options;
+    mkdirSync(dirname(lockPath), { recursive: true });
+    const token = randomBytes(8).toString('hex');
+    const deadline = Date.now() + timeoutMs;
+    let backoff = initialBackoffMs;
+    // ── 获取锁 ──
+    for (;;) {
+        try {
+            const fd = openSync(lockPath, 'wx'); // O_EXCL 独占创建
+            try {
+                const info = { pid: process.pid, time: Date.now(), token };
+                writeFileSync(fd, JSON.stringify(info), 'utf-8');
+            }
+            finally {
+                closeSync(fd);
+            }
+            break; // 持锁成功
+        }
+        catch (err) {
+            if (err.code !== 'EEXIST') {
+                throw err; // 权限/目录等错误直接抛出
+            }
+        }
+        // 已存在：先尝试抢占陈旧锁
+        tryReclaimStale(lockPath, staleMs);
+        // 超时判定
+        if (Date.now() >= deadline) {
+            throw new Error(`获取文件锁超时（${timeoutMs}ms）：${lockPath}`);
+        }
+        // 指数退避 + ±20% 抖动，避免多进程同频重试
+        const jitter = 1 + (Math.random() - 0.5) * 0.4;
+        sleepSync(Math.min(backoff, maxBackoffMs) * jitter);
+        backoff = Math.min(backoff * 2, maxBackoffMs);
+    }
+    // ── 执行临界区并释放 ──
+    try {
+        return fn();
+    }
+    finally {
+        // 归属校验：仅当锁文件仍属于本 token 时删除，避免误删他人/抢占后的新锁
+        const info = readLockInfo(lockPath);
+        if (info?.token === token) {
+            try {
+                unlinkSync(lockPath);
+            }
+            catch {
+                // Windows 占用/已删除：释放失败静默忽略，残留锁由 TTL 兜底（见方案说明）
+            }
+        }
+    }
+}
+//# sourceMappingURL=file-lock.js.map

package/dist/core/fs/file-lock.js.map

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

package/dist/core/fs/sequence.d.ts

@@ -0,0 +1,42 @@
+/** 默认最大尝试次数 */
+export declare const SEQUENCE_MAX_ATTEMPTS_DEFAULT = 1000;
+/** 序号分配选项 */
+export interface ReserveSequenceOptions {
+    /** 目标目录（不存在时自动创建） */
+    dir: string;
+    /** 候选文件名生成器：入参为序号（1 基），返回完整文件名（含扩展名） */
+    candidate: (seq: number) => string;
+    /**
+     * 从已有文件名解析序号，用于计算候选起点。
+     * 返回 null 表示该文件不匹配本序号空间。
+     * 注意：必须只解析文件名，禁止读取文件内容（保证空文件占位语义）。
+     */
+    parse: (fileName: string) => number | null;
+    /** 起始序号；缺省时由 nextSequence(dir, parse) 计算（max+1 快速路径） */
+    start?: number;
+    /** 最大尝试次数，默认 1000 */
+    maxAttempts?: number;
+}
+/** 已分配的序号 */
+export interface ReservedSequence {
+    /** 序号（1 基） */
+    seq: number;
+    /** 已独占创建的文件名 */
+    fileName: string;
+    /** 已独占创建的文件绝对路径（空文件，待调用方写入内容） */
+    path: string;
+}
+/**
+ * 纯计算：扫描目录，返回「最大已用序号 + 1」（空目录/不可读返回 1）。
+ * 仅作 reserveSequence 的候选起点，不承担分配职责。
+ */
+export declare function nextSequence(dir: string, parse: (fileName: string) => number | null): number;
+/**
+ * 原子分配一个序号（O_EXCL 独占创建空文件占位）。
+ *
+ * @param options 目录 / 候选名生成器 / 解析器 / 起点 / 尝试上限
+ * @returns 已独占创建的序号、文件名与路径
+ * @throws 连续 maxAttempts 次候选均被占用时抛出；其它文件系统错误原样抛出
+ */
+export declare function reserveSequence(options: ReserveSequenceOptions): ReservedSequence;
+//# sourceMappingURL=sequence.d.ts.map

package/dist/core/fs/sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../../../src/core/fs/sequence.ts"],"names":[],"mappings":"AAkBA,eAAe;AACf,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD,aAAa;AACb,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC;;;;OAIG;IACH,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC3C,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,aAAa;AACb,MAAM,WAAW,gBAAgB;IAC/B,cAAc;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GACzC,MAAM,CAaR;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,gBAAgB,CA+BjF"}

package/dist/core/fs/sequence.js

@@ -0,0 +1,69 @@
+/**
+ * 原子序号分配工具 — O_EXCL 独占创建 + 冲突递增重试
+ *
+ * 目的：消除「先算 max+1 再写」的跨进程竞态（公共日志 NNN、op-NNN 序号重号）。
+ * 原理：
+ *   - 候选起点由 nextSequence（max+1）计算，仅作单进程快速路径；
+ *   - 逐个候选文件名 openSync(path, 'wx') 独占创建，成功即占号；
+ *   - 已存在（EEXIST）则递增重试，直至上限；
+ *   - 调用方拿到已独占创建的空文件路径后，用原子写写入内容。
+ *
+ * 空文件占位语义（REV-009）：若在占号与写内容之间崩溃会留下空文件，
+ *   但其文件名仍含有效序号，下游 max+1 扫描仍能取到并递增，不重号、不回退。
+ *
+ * 仅依赖 node:fs / node:path，不引入第三方依赖。
+ */
+import { closeSync, mkdirSync, openSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+/** 默认最大尝试次数 */
+export const SEQUENCE_MAX_ATTEMPTS_DEFAULT = 1000;
+/**
+ * 纯计算：扫描目录，返回「最大已用序号 + 1」（空目录/不可读返回 1）。
+ * 仅作 reserveSequence 的候选起点，不承担分配职责。
+ */
+export function nextSequence(dir, parse) {
+    let max = 0;
+    try {
+        for (const entry of readdirSync(dir)) {
+            const seq = parse(entry);
+            if (seq !== null && seq > max) {
+                max = seq;
+            }
+        }
+    }
+    catch {
+        return 1; // 目录不存在/不可读 → 从 1 开始
+    }
+    return max + 1;
+}
+/**
+ * 原子分配一个序号（O_EXCL 独占创建空文件占位）。
+ *
+ * @param options 目录 / 候选名生成器 / 解析器 / 起点 / 尝试上限
+ * @returns 已独占创建的序号、文件名与路径
+ * @throws 连续 maxAttempts 次候选均被占用时抛出；其它文件系统错误原样抛出
+ */
+export function reserveSequence(options) {
+    const { dir, candidate, parse, start, maxAttempts = SEQUENCE_MAX_ATTEMPTS_DEFAULT, } = options;
+    mkdirSync(dir, { recursive: true });
+    // 候选起点：显式 start 优先，否则 max+1（仅快速路径，最终以 O_EXCL 为准）
+    const base = start ?? nextSequence(dir, parse);
+    for (let i = 0; i < maxAttempts; i++) {
+        const seq = base + i;
+        const fileName = candidate(seq);
+        const path = join(dir, fileName);
+        try {
+            const fd = openSync(path, 'wx'); // O_EXCL：已存在则 EEXIST，不覆盖
+            closeSync(fd); // 先占位（空文件），内容由调用方原子写
+            return { seq, fileName, path };
+        }
+        catch (err) {
+            if (err.code === 'EEXIST') {
+                continue; // 序号被占用，递增重试
+            }
+            throw err; // 权限/目录等错误直接抛出
+        }
+    }
+    throw new Error(`序号分配失败：连续 ${maxAttempts} 次候选均被占用（dir=${dir}）`);
+}
+//# sourceMappingURL=sequence.js.map

package/dist/core/fs/sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.js","sourceRoot":"","sources":["../../../src/core/fs/sequence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,eAAe;AACf,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,CAAC;AA8BlD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAW,EACX,KAA0C;IAE1C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;gBAC9B,GAAG,GAAG,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC,CAAC,qBAAqB;IACjC,CAAC;IACD,OAAO,GAAG,GAAG,CAAC,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,MAAM,EACJ,GAAG,EACH,SAAS,EACT,KAAK,EACL,KAAK,EACL,WAAW,GAAG,6BAA6B,GAC5C,GAAG,OAAO,CAAC;IAEZ,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpC,iDAAiD;IACjD,MAAM,IAAI,GAAG,KAAK,IAAI,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAE/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC;QACrB,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,yBAAyB;YAC1D,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,qBAAqB;YACpC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,SAAS,CAAC,aAAa;YACzB,CAAC;YACD,MAAM,GAAG,CAAC,CAAC,eAAe;QAC5B,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,aAAa,WAAW,gBAAgB,GAAG,GAAG,CAAC,CAAC;AAClE,CAAC"}

package/dist/core/global-paths.d.ts

@@ -0,0 +1,27 @@
+/** 全局 opencode 配置根目录（~/.config/opencode） */
+export declare function getOpencodeGlobalDir(): string;
+/** 全局 opencode agents 目录 */
+export declare function getGlobalAgentsDir(): string;
+/** 全局 opencode skills 目录 */
+export declare function getGlobalSkillsDir(): string;
+/** 全局 opencode.jsonc 路径 */
+export declare function getGlobalOpencodeJsoncPath(): string;
+/** 全局框架约束 core.md 路径（~/.config/opencode/openfeel/core.md；v1.1.1 起废弃，仅兼容检测/清理） */
+export declare function getGlobalCoreMdPath(): string;
+/** 全局 AGENTS.md 路径（~/.config/opencode/AGENTS.md；框架约束唯一权威，v1.1.1） */
+export declare function getGlobalAgentsMdPath(): string;
+/** 全局 update_state.json 路径（~/.openfeel/update_state.json） */
+export declare function getGlobalUpdateStatePath(): string;
+/** 全局 update_infos.md 路径（~/.openfeel/update_infos.md；读写属 stage-38，本阶段仅解析路径） */
+export declare function getGlobalUpdateInfosPath(): string;
+/** 全局 auth.json 路径（~/.local/share/opencode/auth.json；模型 provider 校验依据，REV-1505） */
+export declare function getAuthJsonPath(): string;
+/** 全局锁文件路径（~/.openfeel/locks/{name}.lock；跨项目全局写入用，REV-1801） */
+export declare function getGlobalLockPath(name: string): string;
+/** 全局配置文件路径（~/.openfeel/config.json，跨平台兼容，REV-1801） */
+export declare function getGlobalOpenfeelConfigPath(): string;
+/** 全局用户画像路径（~/.config/openfeel/profile.yaml，跨项目共享偏好，REV-1801） */
+export declare function getGlobalProfilePath(): string;
+/** 全局 Schema 目录（~/.openfeel/schemas，Schema 家目录查找层，REV-1801） */
+export declare function getGlobalSchemasDir(): string;
+//# sourceMappingURL=global-paths.d.ts.map

package/dist/core/global-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-paths.d.ts","sourceRoot":"","sources":["../../src/core/global-paths.ts"],"names":[],"mappings":"AASA,4CAA4C;AAC5C,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,4BAA4B;AAC5B,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,4BAA4B;AAC5B,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,2BAA2B;AAC3B,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,6DAA6D;AAC7D,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,+EAA+E;AAC/E,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,mFAAmF;AACnF,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,uDAAuD;AACvD,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED,iEAAiE;AACjE,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/core/global-paths.js

@@ -0,0 +1,61 @@
+/**
+ * 全局路径模块
+ * 集中解析 opencode 与 openfeel 的全局路径（基于用户主目录），
+ * 作为 init/update 全局部署的路径基础。
+ * 仅此模块 import node:os 的 homedir（N4）：测试 mock 一处即隔离全部全局路径。
+ */
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+/** 全局 opencode 配置根目录（~/.config/opencode） */
+export function getOpencodeGlobalDir() {
+    return join(homedir(), '.config', 'opencode');
+}
+/** 全局 opencode agents 目录 */
+export function getGlobalAgentsDir() {
+    return join(getOpencodeGlobalDir(), 'agents');
+}
+/** 全局 opencode skills 目录 */
+export function getGlobalSkillsDir() {
+    return join(getOpencodeGlobalDir(), 'skills');
+}
+/** 全局 opencode.jsonc 路径 */
+export function getGlobalOpencodeJsoncPath() {
+    return join(getOpencodeGlobalDir(), 'opencode.jsonc');
+}
+/** 全局框架约束 core.md 路径（~/.config/opencode/openfeel/core.md；v1.1.1 起废弃，仅兼容检测/清理） */
+export function getGlobalCoreMdPath() {
+    return join(getOpencodeGlobalDir(), 'openfeel', 'core.md');
+}
+/** 全局 AGENTS.md 路径（~/.config/opencode/AGENTS.md；框架约束唯一权威，v1.1.1） */
+export function getGlobalAgentsMdPath() {
+    return join(getOpencodeGlobalDir(), 'AGENTS.md');
+}
+/** 全局 update_state.json 路径（~/.openfeel/update_state.json） */
+export function getGlobalUpdateStatePath() {
+    return join(homedir(), '.openfeel', 'update_state.json');
+}
+/** 全局 update_infos.md 路径（~/.openfeel/update_infos.md；读写属 stage-38，本阶段仅解析路径） */
+export function getGlobalUpdateInfosPath() {
+    return join(homedir(), '.openfeel', 'update_infos.md');
+}
+/** 全局 auth.json 路径（~/.local/share/opencode/auth.json；模型 provider 校验依据，REV-1505） */
+export function getAuthJsonPath() {
+    return join(homedir(), '.local', 'share', 'opencode', 'auth.json');
+}
+/** 全局锁文件路径（~/.openfeel/locks/{name}.lock；跨项目全局写入用，REV-1801） */
+export function getGlobalLockPath(name) {
+    return join(homedir(), '.openfeel', 'locks', `${name}.lock`);
+}
+/** 全局配置文件路径（~/.openfeel/config.json，跨平台兼容，REV-1801） */
+export function getGlobalOpenfeelConfigPath() {
+    return join(homedir(), '.openfeel', 'config.json');
+}
+/** 全局用户画像路径（~/.config/openfeel/profile.yaml，跨项目共享偏好，REV-1801） */
+export function getGlobalProfilePath() {
+    return join(homedir(), '.config', 'openfeel', 'profile.yaml');
+}
+/** 全局 Schema 目录（~/.openfeel/schemas，Schema 家目录查找层，REV-1801） */
+export function getGlobalSchemasDir() {
+    return join(homedir(), '.openfeel', 'schemas');
+}
+//# sourceMappingURL=global-paths.js.map

package/dist/core/global-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-paths.js","sourceRoot":"","sources":["../../src/core/global-paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,4CAA4C;AAC5C,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,oBAAoB,EAAE,EAAE,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,oBAAoB,EAAE,EAAE,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,0BAA0B;IACxC,OAAO,IAAI,CAAC,oBAAoB,EAAE,EAAE,gBAAgB,CAAC,CAAC;AACxD,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,oBAAoB,EAAE,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;AAC7D,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,CAAC,oBAAoB,EAAE,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,wBAAwB;IACtC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC;AAC3D,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,wBAAwB;IACtC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;AACzD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AACrE,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,2BAA2B;IACzC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;AACrD,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;AAChE,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;AACjD,CAAC"}

package/dist/core/i18n-data/en.d.ts

@@ -19,6 +19,9 @@ export declare const instructions: I18nDomain;
 export declare const lint: I18nDomain;
 export declare const help: I18nDomain;
 export declare const config: I18nDomain;
+export declare const migrate: I18nDomain;
+export declare const model: I18nDomain;
+export declare const setup: I18nDomain;
 export declare const allDomains: Array<{
     name: string;
     domain: I18nDomain;

package/dist/core/i18n-data/en.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../src/core/i18n-data/en.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxD,eAAO,MAAM,MAAM,EAAE,UAoBpB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAiLlB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAuBlB,CAAC;AAGF,eAAO,MAAM,MAAM,EAAE,UAiBpB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UA8CrB,CAAC;AAGF,eAAO,MAAM,KAAK,EAAE,UAmBnB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAKlB,CAAC;AAGF,eAAO,MAAM,SAAS,EAAE,UAyBvB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UAOrB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UAAe,CAAC;AAGtC,eAAO,MAAM,IAAI,EAAE,UAQlB,CAAC;AAGF,eAAO,MAAM,YAAY,EAAE,UAAe,CAAC;AAG3C,eAAO,MAAM,IAAI,EAAE,UAalB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAqHlB,CAAC;AAGF,eAAO,MAAM,MAAM,EAAE,UAoBpB,CAAC;AAGF,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAgBlE,CAAC"}
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../src/core/i18n-data/en.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxD,eAAO,MAAM,MAAM,EAAE,UAoBpB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAiLlB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAuBlB,CAAC;AAGF,eAAO,MAAM,MAAM,EAAE,UAoBpB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UA8CrB,CAAC;AAGF,eAAO,MAAM,KAAK,EAAE,UAmBnB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAKlB,CAAC;AAGF,eAAO,MAAM,SAAS,EAAE,UAyBvB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UAOrB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UAAe,CAAC;AAGtC,eAAO,MAAM,IAAI,EAAE,UAQlB,CAAC;AAGF,eAAO,MAAM,YAAY,EAAE,UAAe,CAAC;AAG3C,eAAO,MAAM,IAAI,EAAE,UAalB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UA6IlB,CAAC;AAGF,eAAO,MAAM,MAAM,EAAE,UAoBpB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UA0BrB,CAAC;AAGF,eAAO,MAAM,KAAK,EAAE,UAqBnB,CAAC;AAGF,eAAO,MAAM,KAAK,EAAE,UAKnB,CAAC;AAGF,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAmBlE,CAAC"}

package/dist/core/i18n-data/en.js

@@ -228,6 +228,9 @@ export const update = {
     'langConflict': { key: 'update.langConflict', zh: '', en: '⚠️ AGENTS.md language mismatch: project is {projectLang}, requested is {requestedLang}. Use --force to override or adjust manually.' },
     'conflictsTitle': { key: 'update.conflictsTitle', zh: '', en: 'Conflicts detected (files have been manually modified, overwrite refused)' },
     'conflictsHint': { key: 'update.conflictsHint', zh: '', en: 'Conflict files written to .openfeel/update_conflicts/. Please merge manually, then re-run openfeel update.' },
+    'appendedTitle': { key: 'update.appendedTitle', zh: '', en: 'Appended {n} file(s) (no control-region marker; managed content appended to the end, pending session-start review)' },
+    'appendedHint': { key: 'update.appendedHint', zh: '', en: 'See ~/.openfeel/update_infos.md; each entry will be checked and prompted for repair at session start.' },
+    'appendedManyWarning': { key: 'update.appendedManyWarning', zh: '', en: '⚠️ Appending {n} files at once — possible update_state corruption or first migration. Run openfeel update then check ~/.openfeel/update_infos.md.' },
 };
 /* ==================== project ==================== */
 export const project = {
@@ -371,6 +374,10 @@ export const help = {
     'init': { key: 'help.init', zh: '', en: 'Initialize project workspace, create .openfeel/ directory structure and config files' },
     'init.demo': { key: 'help.init.demo', zh: '', en: 'Create demo project skeleton (NumKit style)' },
     'init.lang': { key: 'help.init.lang', zh: '', en: 'Agent prompt language (zh-CN or en), defaults to zh-CN in non-interactive mode' },
+    'init.workspaceOnly': { key: 'help.init.workspaceOnly', zh: '', en: 'Create the .openfeel/ workspace only (no AGENTS.md/opencode.jsonc); used by Feel to auto-setup blank projects' },
+    'init.nonInteractive': { key: 'help.init.nonInteractive', zh: '', en: 'Non-interactive mode (used together with --workspace-only)' },
+    'setup': { key: 'help.setup', zh: '', en: 'Deploy global OpenFeel framework config (global AGENTS.md + agents + skills + opencode.jsonc); does not create the project .openfeel/' },
+    'setup.lang': { key: 'help.setup.lang', zh: '', en: 'Agent prompt language (zh-CN or en), defaults to zh-CN' },
     'update': { key: 'help.update', zh: '', en: 'Deploy OpenFeel adapter files to target project (interactive tool selection when no args)' },
     'update.lang': { key: 'help.update.lang', zh: '', en: 'Agent prompt language (zh-CN or en)' },
     'update.force': { key: 'help.update.force', zh: '', en: 'Skip AGENTS.md overwrite confirmation, force overwrite' },
@@ -378,7 +385,7 @@ export const help = {
     'flow.status': { key: 'help.flow.status', zh: '', en: 'Show pipeline status summary' },
     'flow.status.verbose': { key: 'help.flow.status.verbose', zh: '', en: 'Enhanced output: config cascade, recent changes, downstream agent readiness' },
     'flow.status.lines': { key: 'help.flow.status.lines', zh: '', en: 'Number of recent status changes (default 5)' },
-    'flow.overview': { key: 'help.flow.overview', zh: '', en: 'Full status visualization (/opfx:status backend)' },
+    'flow.overview': { key: 'help.flow.overview', zh: '', en: 'Full status visualization (openfeel flow overview backend)' },
     'flow.current': { key: 'help.flow.current', zh: '', en: 'Show current stage and operation' },
     'flow.metrics': { key: 'help.flow.metrics', zh: '', en: 'Show Agent performance metrics' },
     'flow.stage': { key: 'help.flow.stage', zh: '', en: 'Stage management' },
@@ -469,6 +476,23 @@ export const help = {
     'lint': { key: 'help.lint', zh: '', en: 'Project health checks (i18n key consistency, kb reference validity)' },
     'lint.i18n': { key: 'help.lint.i18n', zh: '', en: 'Validate i18n key consistency (empty values / zh-CN-only / en-only keys)' },
     'lint.kb': { key: 'help.lint.kb', zh: '', en: 'Detect stale file references in .openfeel/kb/' },
+    // migrate (legacy layout migration)
+    'migrate': { key: 'help.migrate', zh: '', en: 'Legacy layout migration (detect/backup/migrate/rollback existing project legacy layout)' },
+    'migrate.dryRun': { key: 'help.migrate.dryRun', zh: '', en: 'Detect and preview only, do not write' },
+    'migrate.remapAssignee': { key: 'help.migrate.remapAssignee', zh: '', en: 'Rewrite legacy flow.json assignee to new names (report only by default)' },
+    'migrate.rollback': { key: 'help.migrate.rollback', zh: '', en: 'Roll back the most recent migration' },
+    'migrate.rollback.dryRun': { key: 'help.migrate.rollback.dryRun', zh: '', en: 'Preview rollback plan only' },
+    'migrate.cleanGlobalCoreMd': { key: 'help.migrate.cleanGlobalCoreMd', zh: '', en: 'Delete the deprecated global core.md (~/.config/opencode/openfeel/core.md)' },
+    // model (model configuration)
+    'model': { key: 'help.model', zh: '', en: 'Model configuration (three scopes: set/get/list)' },
+    'model.set': { key: 'help.model.set', zh: '', en: 'Set the model of a given agent' },
+    'model.set.scope': { key: 'help.model.set.scope', zh: '', en: 'Scope (default|global|project, default project)' },
+    'model.set.build': { key: 'help.model.set.build', zh: '', en: 'Trigger npm run build after writing default scope to regenerate deploy artifacts' },
+    'model.set.force': { key: 'help.model.set.force', zh: '', en: 'Confirm modifying the framework default (required for --scope default in non-TTY)' },
+    'model.get': { key: 'help.model.get', zh: '', en: 'Read the model of a given agent' },
+    'model.get.scope': { key: 'help.model.get.scope', zh: '', en: 'Scope (omit to show effective value)' },
+    'model.list': { key: 'help.model.list', zh: '', en: 'List models of all agents' },
+    'model.list.scope': { key: 'help.model.list.scope', zh: '', en: 'Scope (omit to show effective value)' },
 };
 /* ==================== config ==================== */
 export const config = {
@@ -492,6 +516,64 @@ export const config = {
     'set.globalValueOk': { key: 'config.set.globalValueOk', zh: '', en: '✓ Global config set: {key} = {value}' },
     'set.globalAllowedKeys': { key: 'config.set.globalAllowedKeys', zh: '', en: 'Supported global config keys: {keys}' },
 };
+/* ==================== migrate domain: legacy layout migration command ==================== */
+export const migrate = {
+    // legacy layout general
+    'legacy.alreadyLatest': { key: 'migrate.legacy.alreadyLatest', zh: '', en: '✓ Already up-to-date layout, no migration needed' },
+    'legacy.done': { key: 'migrate.legacy.done', zh: '', en: 'Migration complete' },
+    // detect report
+    'detect.title': { key: 'migrate.detect.title', zh: '', en: 'Legacy layout detection report:' },
+    'detect.dryRunTitle': { key: 'migrate.detect.dryRunTitle', zh: '', en: '[DRY-RUN Mode] The following migration plan will be applied (not written):' },
+    'detect.dryRunNote': { key: 'migrate.detect.dryRunNote', zh: '', en: '(No files modified, run without --dry-run to apply the migration)' },
+    // backup
+    'backup.dirTmpl': { key: 'migrate.backup.dirTmpl', zh: '', en: 'Backup directory: {dir} (last 5 kept, older ones cleaned)' },
+    // clean
+    'clean.keptCustom': { key: 'migrate.clean.keptCustom', zh: '', en: '(project custom, kept in place)' },
+    // assignee
+    'assignee.title': { key: 'migrate.assignee.title', zh: '', en: 'Legacy flow.json assignee entries (not rewritten by default):' },
+    'assignee.hint': { key: 'migrate.assignee.hint', zh: '', en: 'To rewrite, re-run with --remap-assignee' },
+    // rollback
+    'rollback.dryRunTitle': { key: 'migrate.rollback.dryRunTitle', zh: '', en: '[DRY-RUN Mode] Rollback will restore the following files (not written):' },
+    'rollback.done': { key: 'migrate.rollback.done', zh: '', en: '✓ Rollback complete, restored:' },
+    'rollback.failed': { key: 'migrate.rollback.failed', zh: '', en: '✗ Rollback failed: {message}' },
+    // error
+    'error.pathNotExist': { key: 'migrate.error.pathNotExist', zh: '', en: 'Path does not exist: {path}' },
+    'error.aborted': { key: 'migrate.error.aborted', zh: '', en: 'Migration aborted; run `openfeel migrate rollback` to roll back: {message}' },
+    // deprecated (v1.1.1 compatibility transition)
+    'deprecated.globalCoreMd': { key: 'migrate.deprecated.globalCoreMd', zh: '', en: '? Detected deprecated global core.md (~/.config/opencode/openfeel/core.md); its constraints are now merged into the global AGENTS.md' },
+    'deprecated.globalCoreMdHint': { key: 'migrate.deprecated.globalCoreMdHint', zh: '', en: 'Run openfeel migrate --clean-global-core-md to delete, or remove it manually' },
+    'deprecated.projectAgentsMd': { key: 'migrate.deprecated.projectAgentsMd', zh: '', en: 'i Detected project AGENTS.md (legacy project constraints, now consolidated into the global ~/.config/opencode/AGENTS.md); keep or remove manually' },
+};
+/* ==================== model domain: model configuration (stage-40) ==================== */
+export const model = {
+    // set
+    'set.ok': { key: 'model.set.ok', zh: '', en: '✓ Wrote model {model} for {agentId} (scope={scope})' },
+    'set.warning': { key: 'model.set.warning', zh: '', en: 'Note: {warning}' },
+    'set.needsBuild': { key: 'model.set.needsBuild', zh: '', en: 'default scope changed the framework source; run npm run build to regenerate deploy artifacts' },
+    'set.buildTriggered': { key: 'model.set.buildTriggered', zh: '', en: 'Running npm run build ...' },
+    'set.needConfirm': { key: 'model.set.needConfirm', zh: '', en: 'Modifying the framework default affects all future deployments. In non-TTY you must explicitly pass --force or --build to confirm; execution refused' },
+    'set.noSourceRepo': { key: 'model.set.noSourceRepo', zh: '', en: 'default scope is only available in the OpenFeel source repo (src/core/templates-data not found). Use --scope global/project' },
+    'set.failed': { key: 'model.set.failed', zh: '', en: '✗ Write failed: {message}' },
+    'set.example': { key: 'model.set.example', zh: '', en: 'Example: openfeel model set openfeel-vision deepseek/deepseek-flash --scope global' },
+    // get
+    'get.effective': { key: 'model.get.effective', zh: '', en: 'Effective model: {value}' },
+    'get.byScope': { key: 'model.get.byScope', zh: '', en: '  {scope}: {value}' },
+    'get.none': { key: 'model.get.none', zh: '', en: '(not explicitly set, using opencode default)' },
+    'get.inconsistent': { key: 'model.get.inconsistent', zh: '', en: '⚠ default layer multi-source mismatch (frontmatter differs from opencode-config.ts); frontmatter takes precedence' },
+    'get.shadowed': { key: 'model.get.shadowed', zh: '', en: '⚠ project/global setting is shadowed by the framework default frontmatter (default takes precedence); use --scope default to change the effective value' },
+    'get.failed': { key: 'model.get.failed', zh: '', en: '✗ Read failed: {message}' },
+    // list
+    'list.title': { key: 'model.list.title', zh: '', en: 'Agent model list:' },
+    // error
+    'error.scope': { key: 'model.error.scope', zh: '', en: '✗ {message}' },
+};
+/* ==================== setup domain: global deployment (v1.1.1) ==================== */
+export const setup = {
+    'created': { key: 'setup.created', zh: '', en: 'Created global files:' },
+    'updated': { key: 'setup.updated', zh: '', en: 'Updated global files:' },
+    'appended': { key: 'setup.appended', zh: '', en: 'Global files needing manual confirmation (already exist and are unmanaged; not overwritten):' },
+    'complete': { key: 'setup.complete', zh: '', en: '? Global OpenFeel framework config deployed' },
+};
 /* ==================== 聚合导出 ==================== */
 export const allDomains = [
     { name: 'common', domain: common },
@@ -509,5 +591,8 @@ export const allDomains = [
     { name: 'instructions', domain: instructions },
     { name: 'lint', domain: lint },
     { name: 'config', domain: config },
+    { name: 'migrate', domain: migrate },
+    { name: 'model', domain: model },
+    { name: 'setup', domain: setup },
 ];
 //# sourceMappingURL=en.js.map