@hopping-dev/hub 0.1.0

package/dist/config/manager.js

@@ -0,0 +1,296 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigManager = exports.DEFAULT_ASK_CONFIG = exports.DEFAULT_LOCAL_APPROVAL_CONFIG = exports.DEFAULT_APPROVAL_CONFIG = exports.DEFAULT_CONFIG_FILE = exports.DEFAULT_CONFIG_DIR = void 0;
+exports.toApprovalDecision = toApprovalDecision;
+const fs = __importStar(require("node:fs/promises"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+// ============================================
+// 預設路徑常數
+// ============================================
+exports.DEFAULT_CONFIG_DIR = path.join(os.homedir(), '.hopping');
+exports.DEFAULT_CONFIG_FILE = path.join(exports.DEFAULT_CONFIG_DIR, 'config.json');
+/** TimeoutAction → TimeoutDecision 轉換（送往 Cloud 前使用） */
+function toApprovalDecision(action) {
+    const map = {
+        ask_agent: 'timeout',
+        keep_open: 'pending',
+        auto_approve: 'approved',
+        auto_deny: 'denied',
+    };
+    return map[action];
+}
+exports.DEFAULT_APPROVAL_CONFIG = {
+    timeouts: { low: 30000, medium: 60000, high: 30000, critical: 30000 },
+    onTimeout: { low: 'ask_agent', medium: 'ask_agent', high: 'keep_open', critical: 'keep_open' },
+};
+/** Upper bound for timeout values (4 hours) */
+const MAX_TIMEOUT_MS = 4 * 60 * 60 * 1000; // 14_400_000
+// ============================================
+// LocalApproval Configuration (S3-HUB-LOCAL-001)
+// ============================================
+exports.DEFAULT_LOCAL_APPROVAL_CONFIG = {
+    enabled: true,
+    dialogEnabled: true,
+    soundEnabled: true,
+    raceMode: true,
+};
+// ============================================
+// Ask Config (S4-HUB-RPERM-001)
+// ============================================
+exports.DEFAULT_ASK_CONFIG = {
+    timeoutEnabled: true,
+    timeoutMs: 3_600_000, // 1 hour
+};
+// ============================================
+// ConfigManager
+// ============================================
+/**
+ * ConfigManager — Hub 本地設定持久化
+ *
+ * 負責：
+ * 1. 讀取 ~/.hopping/config.json（配對後取得的 agentId + token）
+ * 2. 配對成功後寫入設定檔（chmod 0o600）
+ * 3. 提供 token 讀取（token 優先順序由呼叫者決定：env > getToken() > 無）
+ */
+class ConfigManager {
+    configPath;
+    constructor(configPath = exports.DEFAULT_CONFIG_FILE) {
+        this.configPath = configPath;
+    }
+    /**
+     * 讀取完整設定
+     * - 找不到檔案或解析失敗時回傳 null（不 throw）
+     */
+    async getConfig() {
+        try {
+            const content = await fs.readFile(this.configPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 取得 token
+     * - 找不到設定或 token 為空時回傳 null
+     */
+    async getToken() {
+        const config = await this.getConfig();
+        return config?.token ?? null;
+    }
+    /**
+     * 配對成功後儲存設定
+     * - 建立 ~/.hopping/ 目錄（若不存在）
+     * - 寫入 config.json，權限設為 0o600
+     */
+    async saveAfterPairing(agentId, token, cloudUrl) {
+        const config = {
+            agentId,
+            token,
+            cloudUrl,
+            pairedAt: new Date().toISOString(),
+        };
+        const dir = path.dirname(this.configPath);
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(this.configPath, JSON.stringify(config, null, 2), {
+            encoding: 'utf-8',
+            mode: 0o600,
+        });
+    }
+    /**
+     * 取得 toolMappings 設定（User Config Layer 1）
+     *
+     * 讀取 ~/.hopping/config.json 的 toolMappings section。
+     * 不存在或解析失敗時回傳 null（不 throw）。
+     */
+    async getToolMappings() {
+        try {
+            const content = await fs.readFile(this.configPath, 'utf-8');
+            const parsed = JSON.parse(content);
+            const toolMappings = parsed['toolMappings'];
+            if (!toolMappings || typeof toolMappings !== 'object') {
+                return null;
+            }
+            // 基本結構檢查：必須有 agents 物件
+            const tm = toolMappings;
+            if (!tm['agents'] || typeof tm['agents'] !== 'object') {
+                return null;
+            }
+            return toolMappings;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 取得 localApproval 設定（REQ-HUB-035）
+     *
+     * 讀取 ~/.hopping/config.json 的 localApproval section，支援 partial override。
+     * 找不到設定或解析失敗時回傳預設值（不 throw）。
+     */
+    async getLocalApprovalConfig() {
+        try {
+            const content = await fs.readFile(this.configPath, 'utf-8');
+            const parsed = JSON.parse(content);
+            const localApproval = parsed['localApproval'];
+            if (!localApproval || typeof localApproval !== 'object') {
+                return { ...exports.DEFAULT_LOCAL_APPROVAL_CONFIG };
+            }
+            const la = localApproval;
+            return {
+                enabled: typeof la['enabled'] === 'boolean'
+                    ? la['enabled']
+                    : exports.DEFAULT_LOCAL_APPROVAL_CONFIG.enabled,
+                dialogEnabled: typeof la['dialogEnabled'] === 'boolean'
+                    ? la['dialogEnabled']
+                    : exports.DEFAULT_LOCAL_APPROVAL_CONFIG.dialogEnabled,
+                soundEnabled: typeof la['soundEnabled'] === 'boolean'
+                    ? la['soundEnabled']
+                    : exports.DEFAULT_LOCAL_APPROVAL_CONFIG.soundEnabled,
+                raceMode: typeof la['raceMode'] === 'boolean'
+                    ? la['raceMode']
+                    : exports.DEFAULT_LOCAL_APPROVAL_CONFIG.raceMode,
+            };
+        }
+        catch {
+            return { ...exports.DEFAULT_LOCAL_APPROVAL_CONFIG };
+        }
+    }
+    /**
+     * 清除本地設定（用於取消配對）
+     * - 找不到檔案時不 throw
+     */
+    async clear() {
+        try {
+            await fs.unlink(this.configPath);
+        }
+        catch (err) {
+            // ENOENT = 檔案不存在，視為成功
+            if (err.code !== 'ENOENT') {
+                throw err;
+            }
+        }
+    }
+    /**
+     * 取得 askConfig 設定（REQ-HUB-042）
+     *
+     * 讀取 ~/.hopping/config.json 的 askConfig section，支援 partial override。
+     * 找不到設定或解析失敗時回傳預設值（timeoutEnabled: true, timeoutMs: 1hr）。
+     */
+    async getAskConfig() {
+        try {
+            const content = await fs.readFile(this.configPath, 'utf-8');
+            const parsed = JSON.parse(content);
+            const askConfig = parsed['askConfig'];
+            if (!askConfig || typeof askConfig !== 'object') {
+                return { ...exports.DEFAULT_ASK_CONFIG };
+            }
+            const ac = askConfig;
+            return {
+                timeoutEnabled: typeof ac['timeoutEnabled'] === 'boolean'
+                    ? ac['timeoutEnabled']
+                    : exports.DEFAULT_ASK_CONFIG.timeoutEnabled,
+                timeoutMs: typeof ac['timeoutMs'] === 'number' && ac['timeoutMs'] > 0
+                    ? ac['timeoutMs']
+                    : exports.DEFAULT_ASK_CONFIG.timeoutMs,
+            };
+        }
+        catch {
+            return { ...exports.DEFAULT_ASK_CONFIG };
+        }
+    }
+    /**
+     * 取得 Approval timeout 設定
+     *
+     * 優先序：HOPPING_APPROVAL_TIMEOUT_MS env > config.json approval section > defaults
+     */
+    async getApprovalConfig() {
+        // 1. env var overrides all timeouts
+        const envTimeout = process.env['HOPPING_APPROVAL_TIMEOUT_MS'];
+        if (envTimeout) {
+            const ms = parseInt(envTimeout, 10);
+            if (!isNaN(ms) && ms > 0 && ms <= MAX_TIMEOUT_MS) {
+                return {
+                    timeouts: { low: ms, medium: ms, high: ms, critical: ms },
+                    onTimeout: { ...exports.DEFAULT_APPROVAL_CONFIG.onTimeout },
+                };
+            }
+        }
+        // 2. config.json approval section
+        let fileConfig = null;
+        try {
+            const content = await fs.readFile(this.configPath, 'utf-8');
+            fileConfig = JSON.parse(content);
+        }
+        catch {
+            // file not found or invalid JSON → use defaults
+        }
+        if (!fileConfig ||
+            typeof fileConfig['approval'] !== 'object' ||
+            fileConfig['approval'] === null) {
+            return { ...exports.DEFAULT_APPROVAL_CONFIG };
+        }
+        const approval = fileConfig['approval'];
+        const result = {
+            timeouts: { ...exports.DEFAULT_APPROVAL_CONFIG.timeouts },
+            onTimeout: { ...exports.DEFAULT_APPROVAL_CONFIG.onTimeout },
+        };
+        // merge timeouts
+        if (typeof approval['timeouts'] === 'object' && approval['timeouts'] !== null) {
+            const t = approval['timeouts'];
+            for (const key of ['low', 'medium', 'high', 'critical']) {
+                const val = t[key];
+                if (typeof val === 'number' && val > 0 && val <= MAX_TIMEOUT_MS) {
+                    result.timeouts[key] = val;
+                }
+            }
+        }
+        // merge onTimeout
+        if (typeof approval['onTimeout'] === 'object' && approval['onTimeout'] !== null) {
+            const ot = approval['onTimeout'];
+            const validActions = ['ask_agent', 'keep_open', 'auto_approve', 'auto_deny'];
+            for (const key of ['low', 'medium', 'high', 'critical']) {
+                if (typeof ot[key] === 'string' && validActions.includes(ot[key])) {
+                    result.onTimeout[key] = ot[key];
+                }
+            }
+        }
+        return result;
+    }
+}
+exports.ConfigManager = ConfigManager;
+//# sourceMappingURL=manager.js.map

package/dist/config/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/config/manager.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,gDAQC;AAlCD,qDAAuC;AACvC,4CAA8B;AAC9B,gDAAkC;AASlC,+CAA+C;AAC/C,SAAS;AACT,+CAA+C;AAElC,QAAA,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AACzD,QAAA,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,0BAAkB,EAAE,aAAa,CAAC,CAAC;AAShF,uDAAuD;AACvD,SAAgB,kBAAkB,CAAC,MAAqB;IACtD,MAAM,GAAG,GAA2C;QAClD,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;QACpB,YAAY,EAAE,UAAU;QACxB,SAAS,EAAE,QAAQ;KACpB,CAAC;IACF,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC;AACrB,CAAC;AAOY,QAAA,uBAAuB,GAA0B;IAC5D,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;IACrE,SAAS,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE;CAC/F,CAAC;AAEF,+CAA+C;AAC/C,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAExD,+CAA+C;AAC/C,iDAAiD;AACjD,+CAA+C;AAElC,QAAA,6BAA6B,GAAwB;IAChE,OAAO,EAAE,IAAI;IACb,aAAa,EAAE,IAAI;IACnB,YAAY,EAAE,IAAI;IAClB,QAAQ,EAAE,IAAI;CACf,CAAC;AAEF,+CAA+C;AAC/C,gCAAgC;AAChC,+CAA+C;AAElC,QAAA,kBAAkB,GAAc;IAC3C,cAAc,EAAE,IAAI;IACpB,SAAS,EAAE,SAAS,EAAE,SAAS;CAChC,CAAC;AAEF,+CAA+C;AAC/C,gBAAgB;AAChB,+CAA+C;AAE/C;;;;;;;GAOG;AACH,MAAa,aAAa;IAChB,UAAU,CAAS;IAE3B,YAAY,aAAqB,2BAAmB;QAClD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAmB,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,EAAE,KAAK,IAAI,IAAI,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAAe,EAAE,KAAa,EAAE,QAAgB;QACrE,MAAM,MAAM,GAAmB;YAC7B,OAAO;YACP,KAAK;YACL,QAAQ;YACR,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACnC,CAAC;QAEF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;YACnE,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe;QACnB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;YAC9D,MAAM,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;YAC5C,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;gBACtD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,uBAAuB;YACvB,MAAM,EAAE,GAAG,YAAuC,CAAC;YACnD,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,OAAO,EAAE,CAAC,QAAQ,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACtD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,YAA4B,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,sBAAsB;QAC1B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;YAC9D,MAAM,aAAa,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;YAE9C,IAAI,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;gBACxD,OAAO,EAAE,GAAG,qCAA6B,EAAE,CAAC;YAC9C,CAAC;YAED,MAAM,EAAE,GAAG,aAAwC,CAAC;YACpD,OAAO;gBACL,OAAO,EACL,OAAO,EAAE,CAAC,SAAS,CAAC,KAAK,SAAS;oBAChC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC;oBACf,CAAC,CAAC,qCAA6B,CAAC,OAAO;gBAC3C,aAAa,EACX,OAAO,EAAE,CAAC,eAAe,CAAC,KAAK,SAAS;oBACtC,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC;oBACrB,CAAC,CAAC,qCAA6B,CAAC,aAAa;gBACjD,YAAY,EACV,OAAO,EAAE,CAAC,cAAc,CAAC,KAAK,SAAS;oBACrC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC;oBACpB,CAAC,CAAC,qCAA6B,CAAC,YAAY;gBAChD,QAAQ,EACN,OAAO,EAAE,CAAC,UAAU,CAAC,KAAK,SAAS;oBACjC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC;oBAChB,CAAC,CAAC,qCAA6B,CAAC,QAAQ;aAC7C,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,GAAG,qCAA6B,EAAE,CAAC;QAC9C,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,sBAAsB;YACtB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;YAC9D,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;YAEtC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAChD,OAAO,EAAE,GAAG,0BAAkB,EAAE,CAAC;YACnC,CAAC;YAED,MAAM,EAAE,GAAG,SAAoC,CAAC;YAChD,OAAO;gBACL,cAAc,EACZ,OAAO,EAAE,CAAC,gBAAgB,CAAC,KAAK,SAAS;oBACvC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC;oBACtB,CAAC,CAAC,0BAAkB,CAAC,cAAc;gBACvC,SAAS,EACP,OAAO,EAAE,CAAC,WAAW,CAAC,KAAK,QAAQ,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC;oBACxD,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC;oBACjB,CAAC,CAAC,0BAAkB,CAAC,SAAS;aACnC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,GAAG,0BAAkB,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB;QACrB,oCAAoC;QACpC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC9D,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,EAAE,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YACpC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,cAAc,EAAE,CAAC;gBACjD,OAAO;oBACL,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;oBACzD,SAAS,EAAE,EAAE,GAAG,+BAAuB,CAAC,SAAS,EAAE;iBACpD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,kCAAkC;QAClC,IAAI,UAAU,GAAmC,IAAI,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC5D,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,gDAAgD;QAClD,CAAC;QAED,IACE,CAAC,UAAU;YACX,OAAO,UAAU,CAAC,UAAU,CAAC,KAAK,QAAQ;YAC1C,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,EAC/B,CAAC;YACD,OAAO,EAAE,GAAG,+BAAuB,EAAE,CAAC;QACxC,CAAC;QAED,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAA4B,CAAC;QACnE,MAAM,MAAM,GAA0B;YACpC,QAAQ,EAAE,EAAE,GAAG,+BAAuB,CAAC,QAAQ,EAAE;YACjD,SAAS,EAAE,EAAE,GAAG,+BAAuB,CAAC,SAAS,EAAE;SACpD,CAAC;QAEF,iBAAiB;QACjB,IAAI,OAAO,QAAQ,CAAC,UAAU,CAAC,KAAK,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9E,MAAM,CAAC,GAAG,QAAQ,CAAC,UAAU,CAA4B,CAAC;YAC1D,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAU,EAAE,CAAC;gBACjE,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;gBACnB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,cAAc,EAAE,CAAC;oBAChE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,IAAI,OAAO,QAAQ,CAAC,WAAW,CAAC,KAAK,QAAQ,IAAI,QAAQ,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC;YAChF,MAAM,EAAE,GAAG,QAAQ,CAAC,WAAW,CAA4B,CAAC;YAC5D,MAAM,YAAY,GAAoB,CAAC,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;YAE9F,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAU,EAAE,CAAC;gBACjE,IAAI,OAAO,EAAE,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAkB,CAAC,EAAE,CAAC;oBACnF,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAkB,CAAC;gBACnD,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AArOD,sCAqOC"}

package/dist/dev-mode.d.ts

@@ -0,0 +1,30 @@
+import { DevMode } from '@hopping/shared';
+/**
+ * 開發模式控制（雞生蛋解法）
+ *
+ * 解決「用 Claude Code 開發攔截 Claude Code 的工具」的問題
+ *
+ * - isolated:  完全不攔截（預設，開發時用）
+ * - allowlist: 只攔截指定工具（Hub 開發時用）
+ * - full:      完整攔截（整合測試時用）
+ * - yolo:      觀測模式 — Policy Engine 仍執行（取得 riskLevel），但全部 auto-approve + 完整記錄
+ */
+export declare const DEV_MODE: DevMode;
+/**
+ * 判斷是否應該攔截該工具
+ * yolo 模式回傳 true：確保 Policy Engine 仍執行（取得 riskLevel 用於觀測），
+ * 但後續 handleCheck / handlePendingFile 會走 YOLO auto-approve 路徑，而非送審。
+ */
+export declare function shouldIntercept(toolName: string): boolean;
+/**
+ * 是否為 YOLO 觀測模式
+ */
+export declare function isYoloMode(): boolean;
+/**
+ * 取得目前開發模式資訊
+ */
+export declare function getDevModeInfo(): {
+    mode: DevMode;
+    allowlist: string[];
+};
+//# sourceMappingURL=dev-mode.d.ts.map

package/dist/dev-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-mode.d.ts","sourceRoot":"","sources":["../src/dev-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,EAAE,OAAiE,CAAC;AAIzF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAazD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAKvE"}

package/dist/dev-mode.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEV_MODE = void 0;
+exports.shouldIntercept = shouldIntercept;
+exports.isYoloMode = isYoloMode;
+exports.getDevModeInfo = getDevModeInfo;
+/**
+ * 開發模式控制（雞生蛋解法）
+ *
+ * 解決「用 Claude Code 開發攔截 Claude Code 的工具」的問題
+ *
+ * - isolated:  完全不攔截（預設，開發時用）
+ * - allowlist: 只攔截指定工具（Hub 開發時用）
+ * - full:      完整攔截（整合測試時用）
+ * - yolo:      觀測模式 — Policy Engine 仍執行（取得 riskLevel），但全部 auto-approve + 完整記錄
+ */
+exports.DEV_MODE = (process.env.HOPPING_DEV_MODE || 'isolated');
+const ALLOWLIST = (process.env.HOPPING_ALLOWLIST || '').split(',').filter(Boolean);
+/**
+ * 判斷是否應該攔截該工具
+ * yolo 模式回傳 true：確保 Policy Engine 仍執行（取得 riskLevel 用於觀測），
+ * 但後續 handleCheck / handlePendingFile 會走 YOLO auto-approve 路徑，而非送審。
+ */
+function shouldIntercept(toolName) {
+    switch (exports.DEV_MODE) {
+        case 'isolated':
+            return false;
+        case 'full':
+            return true;
+        case 'yolo':
+            return true;
+        case 'allowlist':
+            return ALLOWLIST.includes(toolName);
+        default:
+            return false;
+    }
+}
+/**
+ * 是否為 YOLO 觀測模式
+ */
+function isYoloMode() {
+    return exports.DEV_MODE === 'yolo';
+}
+/**
+ * 取得目前開發模式資訊
+ */
+function getDevModeInfo() {
+    return {
+        mode: exports.DEV_MODE,
+        allowlist: ALLOWLIST,
+    };
+}
+//# sourceMappingURL=dev-mode.js.map

package/dist/dev-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-mode.js","sourceRoot":"","sources":["../src/dev-mode.ts"],"names":[],"mappings":";;;AAqBA,0CAaC;AAKD,gCAEC;AAKD,wCAKC;AAjDD;;;;;;;;;GASG;AACU,QAAA,QAAQ,GAAY,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,UAAU,CAAY,CAAC;AAEzF,MAAM,SAAS,GAAa,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAE7F;;;;GAIG;AACH,SAAgB,eAAe,CAAC,QAAgB;IAC9C,QAAQ,gBAAQ,EAAE,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,KAAK,CAAC;QACf,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;QACd,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;QACd,KAAK,WAAW;YACd,OAAO,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACtC;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU;IACxB,OAAO,gBAAQ,KAAK,MAAM,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc;IAC5B,OAAO;QACL,IAAI,EAAE,gBAAQ;QACd,SAAS,EAAE,SAAS;KACrB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { Logger } from './utils/logger';
+import { PolicyStore } from './policy/store';
+import { PolicyEngine } from './policy/engine';
+import { ApprovalManager } from './approval/manager';
+declare const logger: Logger;
+declare const policyStore: PolicyStore;
+declare const policyEngine: PolicyEngine;
+declare const approvalManager: ApprovalManager;
+export { logger, policyStore, policyEngine, approvalManager };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAiBrD,QAAA,MAAM,MAAM,QAAoC,CAAC;AAIjD,QAAA,MAAM,WAAW,aAA0B,CAAC;AAC5C,QAAA,MAAM,YAAY,cAAwC,CAAC;AAC3D,QAAA,MAAM,eAAe,iBAA8B,CAAC;AA0TpD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC"}