feique 1.1.0

package/dist/projects/paths.js

@@ -0,0 +1,30 @@
+import path from 'node:path';
+export function getProjectStateDir(storageDir, projectAlias) {
+    return path.join(storageDir, 'projects', sanitizeProjectAlias(projectAlias));
+}
+export function getProjectDownloadsDir(storageDir, projectAlias, project) {
+    return project.download_dir ? path.resolve(project.download_dir) : path.join(getProjectStateDir(storageDir, projectAlias), 'downloads');
+}
+export function getProjectTempDir(storageDir, projectAlias, project) {
+    return project.temp_dir ? path.resolve(project.temp_dir) : path.join(getProjectStateDir(storageDir, projectAlias), 'tmp');
+}
+export function getProjectCacheDir(storageDir, projectAlias, project) {
+    return project.cache_dir ? path.resolve(project.cache_dir) : path.join(getProjectStateDir(storageDir, projectAlias), 'cache');
+}
+export function getProjectLogDir(storageDir, projectAlias, project) {
+    return project.log_dir ? path.resolve(project.log_dir) : path.join(getProjectStateDir(storageDir, projectAlias), 'logs');
+}
+export function getProjectAuditDir(storageDir, projectAlias, project) {
+    return getProjectLogDir(storageDir, projectAlias, project);
+}
+export function getProjectAuditFile(storageDir, projectAlias, project) {
+    return path.join(getProjectAuditDir(storageDir, projectAlias, project), 'project-audit.jsonl');
+}
+export function getProjectArchiveDir(storageDir, projectAlias) {
+    return path.join(getProjectStateDir(storageDir, projectAlias), 'archive');
+}
+function sanitizeProjectAlias(value) {
+    const normalized = value.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, '-');
+    return normalized.length > 0 ? normalized : 'default';
+}
+//# sourceMappingURL=paths.js.map

package/dist/projects/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/projects/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,YAAoB;IACzE,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAkB,EAAE,YAAoB,EAAE,OAAsB;IACrG,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,WAAW,CAAC,CAAC;AAC1I,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,YAAoB,EAAE,OAAsB;IAChG,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5H,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,YAAoB,EAAE,OAAsB;IACjG,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAChI,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAkB,EAAE,YAAoB,EAAE,OAAsB;IAC/F,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;AAC3H,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,YAAoB,EAAE,OAAsB;IACjG,OAAO,gBAAgB,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAkB,EAAE,YAAoB,EAAE,OAAsB;IAClG,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,qBAAqB,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAkB,EAAE,YAAoB;IAC3E,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACzC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAC7E,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC"}

package/dist/runtime/instance-lock.d.ts

@@ -0,0 +1,12 @@
+export interface InstanceLock {
+    lockPath: string;
+    release(): Promise<void>;
+}
+export declare function acquireInstanceLock(options: {
+    storageDir: string;
+    serviceName: string;
+    cwd?: string;
+    ownerPid?: number;
+    transport?: string;
+    isProcessAlive?: (pid: number) => boolean;
+}): Promise<InstanceLock>;

package/dist/runtime/instance-lock.js

@@ -0,0 +1,99 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { ensureDir } from '../utils/fs.js';
+export async function acquireInstanceLock(options) {
+    await ensureDir(options.storageDir);
+    const lockPath = path.join(options.storageDir, `${options.serviceName}.lock`);
+    const payload = {
+        instance_id: randomUUID(),
+        pid: options.ownerPid ?? process.pid,
+        started_at: new Date().toISOString(),
+        cwd: options.cwd ?? process.cwd(),
+        ...(options.transport ? { transport: options.transport } : {}),
+    };
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+        try {
+            await fs.writeFile(lockPath, JSON.stringify(payload, null, 2), { encoding: 'utf8', flag: 'wx' });
+            return {
+                lockPath,
+                release: async () => {
+                    try {
+                        const current = await readLockPayload(lockPath);
+                        if (!current || current.instance_id !== payload.instance_id) {
+                            return;
+                        }
+                        await fs.unlink(lockPath);
+                    }
+                    catch (error) {
+                        if (isMissingFileError(error)) {
+                            return;
+                        }
+                        throw error;
+                    }
+                },
+            };
+        }
+        catch (error) {
+            if (!isFileExistsError(error)) {
+                throw error;
+            }
+            const existing = await readLockPayload(lockPath);
+            if (existing && isKnownLiveProcess(existing.pid, options.isProcessAlive)) {
+                throw new Error(`Another ${options.serviceName} instance is already running (pid ${existing.pid}). Lock: ${lockPath}`);
+            }
+            await fs.rm(lockPath, { force: true });
+        }
+    }
+    throw new Error(`Unable to acquire instance lock: ${lockPath}`);
+}
+async function readLockPayload(lockPath) {
+    try {
+        const content = await fs.readFile(lockPath, 'utf8');
+        const parsed = JSON.parse(content);
+        if (typeof parsed.instance_id !== 'string' || typeof parsed.pid !== 'number' || typeof parsed.started_at !== 'string') {
+            return null;
+        }
+        return {
+            instance_id: parsed.instance_id,
+            pid: parsed.pid,
+            started_at: parsed.started_at,
+            cwd: typeof parsed.cwd === 'string' ? parsed.cwd : '',
+            transport: typeof parsed.transport === 'string' ? parsed.transport : undefined,
+        };
+    }
+    catch (error) {
+        if (isMissingFileError(error)) {
+            return null;
+        }
+        return null;
+    }
+}
+function isKnownLiveProcess(pid, checker) {
+    if (!Number.isInteger(pid) || pid <= 0) {
+        return false;
+    }
+    if (checker) {
+        return checker(pid);
+    }
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return !isMissingProcessError(error);
+    }
+}
+function isFileExistsError(error) {
+    return isErrorWithCode(error, 'EEXIST');
+}
+function isMissingFileError(error) {
+    return isErrorWithCode(error, 'ENOENT');
+}
+function isMissingProcessError(error) {
+    return isErrorWithCode(error, 'ESRCH');
+}
+function isErrorWithCode(error, code) {
+    return error instanceof Error && 'code' in error && error.code === code;
+}
+//# sourceMappingURL=instance-lock.js.map

package/dist/runtime/instance-lock.js.map

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

package/dist/runtime/process.d.ts

@@ -0,0 +1,2 @@
+export declare function isProcessAlive(pid: number): boolean;
+export declare function terminateProcess(pid: number, signal?: NodeJS.Signals): boolean;

package/dist/runtime/process.js

@@ -0,0 +1,43 @@
+import { spawnSync } from 'node:child_process';
+export function isProcessAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0) {
+        return false;
+    }
+    try {
+        process.kill(pid, 0);
+    }
+    catch (error) {
+        return !(error instanceof Error && 'code' in error && error.code === 'ESRCH');
+    }
+    const unixState = readUnixProcessState(pid);
+    if (unixState?.startsWith('Z')) {
+        return false;
+    }
+    return true;
+}
+export function terminateProcess(pid, signal = 'SIGTERM') {
+    if (!Number.isInteger(pid) || pid <= 0) {
+        return false;
+    }
+    try {
+        process.kill(pid, signal);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function readUnixProcessState(pid) {
+    if (process.platform === 'win32') {
+        return null;
+    }
+    const result = spawnSync('ps', ['-o', 'stat=', '-p', String(pid)], {
+        encoding: 'utf8',
+    });
+    if (result.status !== 0) {
+        return null;
+    }
+    const output = result.stdout.trim();
+    return output.length > 0 ? output : null;
+}
+//# sourceMappingURL=process.js.map

package/dist/runtime/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/runtime/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,CAAC,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,SAAyB,SAAS;IAC9E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAW;IACvC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE;QACjE,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACpC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3C,CAAC"}

package/dist/runtime/shutdown.d.ts

@@ -0,0 +1,11 @@
+import type { Logger } from '../logging.js';
+export interface ShutdownSignalTarget {
+    on(event: NodeJS.Signals, listener: () => void): unknown;
+    off(event: NodeJS.Signals, listener: () => void): unknown;
+}
+export declare function waitForShutdownSignal(options: {
+    logger: Logger;
+    onShutdown: (signal: NodeJS.Signals) => Promise<void> | void;
+    target?: ShutdownSignalTarget;
+    signals?: NodeJS.Signals[];
+}): Promise<NodeJS.Signals>;

package/dist/runtime/shutdown.js

@@ -0,0 +1,38 @@
+const DEFAULT_SIGNALS = ['SIGINT', 'SIGTERM'];
+export async function waitForShutdownSignal(options) {
+    const target = options.target ?? process;
+    const signals = options.signals ?? DEFAULT_SIGNALS;
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const listeners = new Map();
+        const cleanup = () => {
+            for (const [signal, listener] of listeners) {
+                target.off(signal, listener);
+            }
+            listeners.clear();
+        };
+        const finish = async (signal) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            cleanup();
+            options.logger.info({ signal }, 'Received shutdown signal');
+            try {
+                await options.onShutdown(signal);
+                resolve(signal);
+            }
+            catch (error) {
+                reject(error);
+            }
+        };
+        for (const signal of signals) {
+            const listener = () => {
+                void finish(signal);
+            };
+            listeners.set(signal, listener);
+            target.on(signal, listener);
+        }
+    });
+}
+//# sourceMappingURL=shutdown.js.map

package/dist/runtime/shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.js","sourceRoot":"","sources":["../../src/runtime/shutdown.ts"],"names":[],"mappings":"AAOA,MAAM,eAAe,GAAqB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEhE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAK3C;IACC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC;IACzC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC;IAEnD,OAAO,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAC;QAExD,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC3C,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC/B,CAAC;YACD,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,KAAK,EAAE,MAAsB,EAAE,EAAE;YAC9C,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC;YAE5D,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBACjC,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,GAAG,EAAE;gBACpB,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC;YACtB,CAAC,CAAC;YACF,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAChC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/security/access.d.ts

@@ -0,0 +1,13 @@
+import type { BridgeConfig } from '../config/schema.js';
+export type AccessRole = 'viewer' | 'operator' | 'admin';
+export type ProjectCapability = 'project:view' | 'project:switch' | 'session:list' | 'session:control' | 'run:execute' | 'run:cancel' | 'project:mutate';
+export type GlobalCapability = 'service:status' | 'service:runs' | 'service:restart' | 'config:history' | 'config:rollback' | 'config:mutate';
+export declare function resolveProjectAccessRole(config: BridgeConfig, projectAlias: string, chatId: string): AccessRole | null;
+export declare function canAccessProject(config: BridgeConfig, projectAlias: string, chatId: string, minimumRole?: AccessRole): boolean;
+export declare function filterAccessibleProjects(config: BridgeConfig, chatId: string, minimumRole?: AccessRole): string[];
+export declare function canAccessProjectCapability(config: BridgeConfig, projectAlias: string, chatId: string, capability: ProjectCapability): boolean;
+export declare function canAccessGlobalCapability(config: BridgeConfig, chatId: string, capability: GlobalCapability): boolean;
+export declare function describeMinimumRole(role: AccessRole): string;
+export declare function hasAccessGuard(config: BridgeConfig, projectAlias: string): boolean;
+export declare function hasProjectCapabilityOverride(config: BridgeConfig, projectAlias: string, capability: ProjectCapability): boolean;
+export declare function hasGlobalCapabilityOverride(config: BridgeConfig, capability: GlobalCapability): boolean;

package/dist/security/access.js

@@ -0,0 +1,160 @@
+const ROLE_ORDER = ['viewer', 'operator', 'admin'];
+export function resolveProjectAccessRole(config, projectAlias, chatId) {
+    return maxRole([
+        resolveGlobalRole(config, chatId),
+        resolveScopedRole(config.projects[projectAlias]?.viewer_chat_ids, config.projects[projectAlias]?.operator_chat_ids, config.projects[projectAlias]?.admin_chat_ids, chatId),
+    ]);
+}
+export function canAccessProject(config, projectAlias, chatId, minimumRole = 'viewer') {
+    if (!hasAccessGuard(config, projectAlias)) {
+        return true;
+    }
+    const actual = resolveProjectAccessRole(config, projectAlias, chatId);
+    return actual !== null && roleRank(actual) >= roleRank(minimumRole);
+}
+export function filterAccessibleProjects(config, chatId, minimumRole = 'viewer') {
+    return Object.keys(config.projects).filter((alias) => canAccessProject(config, alias, chatId, minimumRole));
+}
+export function canAccessProjectCapability(config, projectAlias, chatId, capability) {
+    const project = config.projects[projectAlias];
+    if (!project) {
+        return false;
+    }
+    const overrideList = resolveProjectCapabilityList(config, projectAlias, capability);
+    if (hasEntries(overrideList)) {
+        const scopedList = overrideList;
+        if (scopedList.includes(chatId)) {
+            return true;
+        }
+        if (capability === 'project:mutate') {
+            return canAccessProject(config, projectAlias, chatId, 'admin');
+        }
+        return false;
+    }
+    switch (capability) {
+        case 'project:view':
+        case 'project:switch':
+        case 'session:list':
+            return canAccessProject(config, projectAlias, chatId, 'viewer');
+        case 'session:control':
+        case 'run:execute':
+        case 'run:cancel':
+            return canAccessProject(config, projectAlias, chatId, 'operator');
+        case 'project:mutate':
+            return canAccessProject(config, projectAlias, chatId, 'admin');
+    }
+}
+export function canAccessGlobalCapability(config, chatId, capability) {
+    const overrideList = resolveGlobalCapabilityList(config, capability);
+    if (hasEntries(overrideList)) {
+        const scopedList = overrideList;
+        if (scopedList.includes(chatId)) {
+            return true;
+        }
+        if (capability === 'service:restart' || capability === 'config:history' || capability === 'config:rollback' || capability === 'config:mutate') {
+            const globalRole = resolveGlobalRole(config, chatId);
+            return globalRole !== null && roleRank(globalRole) >= roleRank('admin');
+        }
+        return false;
+    }
+    const globalRole = resolveGlobalRole(config, chatId);
+    switch (capability) {
+        case 'service:status':
+        case 'service:runs':
+            return globalRole !== null && roleRank(globalRole) >= roleRank('operator');
+        case 'service:restart':
+        case 'config:history':
+        case 'config:rollback':
+        case 'config:mutate':
+            return globalRole !== null && roleRank(globalRole) >= roleRank('admin');
+    }
+}
+export function describeMinimumRole(role) {
+    switch (role) {
+        case 'viewer':
+            return 'viewer';
+        case 'operator':
+            return 'operator';
+        case 'admin':
+            return 'admin';
+    }
+}
+export function hasAccessGuard(config, projectAlias) {
+    return (hasEntries(config.security.viewer_chat_ids) ||
+        hasEntries(config.security.operator_chat_ids) ||
+        hasEntries(config.security.admin_chat_ids) ||
+        hasEntries(config.projects[projectAlias]?.viewer_chat_ids) ||
+        hasEntries(config.projects[projectAlias]?.operator_chat_ids) ||
+        hasEntries(config.projects[projectAlias]?.admin_chat_ids));
+}
+export function hasProjectCapabilityOverride(config, projectAlias, capability) {
+    const list = resolveProjectCapabilityList(config, projectAlias, capability);
+    return Array.isArray(list) && list.length > 0;
+}
+export function hasGlobalCapabilityOverride(config, capability) {
+    const list = resolveGlobalCapabilityList(config, capability);
+    return Array.isArray(list) && list.length > 0;
+}
+function resolveGlobalRole(config, chatId) {
+    return resolveScopedRole(config.security.viewer_chat_ids, config.security.operator_chat_ids, config.security.admin_chat_ids, chatId);
+}
+function resolveProjectCapabilityList(config, projectAlias, capability) {
+    const project = config.projects[projectAlias];
+    if (!project) {
+        return undefined;
+    }
+    switch (capability) {
+        case 'session:control':
+            return project.session_operator_chat_ids;
+        case 'run:execute':
+        case 'run:cancel':
+            return project.run_operator_chat_ids;
+        case 'project:mutate':
+            return project.config_admin_chat_ids;
+        default:
+            return undefined;
+    }
+}
+function resolveGlobalCapabilityList(config, capability) {
+    switch (capability) {
+        case 'service:status':
+        case 'service:runs':
+            return config.security.service_observer_chat_ids;
+        case 'service:restart':
+            return config.security.service_restart_chat_ids;
+        case 'config:history':
+        case 'config:rollback':
+        case 'config:mutate':
+            return config.security.config_admin_chat_ids;
+    }
+}
+function resolveScopedRole(viewerChatIds, operatorChatIds, adminChatIds, chatId) {
+    if (adminChatIds?.includes(chatId)) {
+        return 'admin';
+    }
+    if (operatorChatIds?.includes(chatId)) {
+        return 'operator';
+    }
+    if (viewerChatIds?.includes(chatId)) {
+        return 'viewer';
+    }
+    return null;
+}
+function maxRole(roles) {
+    return roles.reduce((best, current) => {
+        if (!current) {
+            return best;
+        }
+        if (!best) {
+            return current;
+        }
+        return roleRank(current) > roleRank(best) ? current : best;
+    }, null);
+}
+function roleRank(role) {
+    return ROLE_ORDER.indexOf(role);
+}
+function hasEntries(value) {
+    return Array.isArray(value) && value.length > 0;
+}
+//# sourceMappingURL=access.js.map

package/dist/security/access.js.map

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

package/dist/service/install.d.ts

@@ -0,0 +1,19 @@
+import { type ServiceDescriptor } from './templates.js';
+export interface InstallServiceOptions {
+    serviceName: string;
+    cliScriptPath: string;
+    nodeBinaryPath: string;
+    workingDirectory: string;
+    configPath?: string;
+    logDirectory?: string;
+    platform?: NodeJS.Platform;
+}
+export declare function resolveDefaultLogDirectory(): string;
+export declare function installServiceFile(options: InstallServiceOptions): Promise<ServiceDescriptor>;
+export declare function uninstallServiceFile(options: {
+    serviceName: string;
+    platform?: NodeJS.Platform;
+}): Promise<{
+    removed: boolean;
+    targetPath: string;
+}>;

package/dist/service/install.js

@@ -0,0 +1,35 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+import { ensureDir, fileExists, writeUtf8Atomic } from '../utils/fs.js';
+import { buildServiceDescriptor } from './templates.js';
+export function resolveDefaultLogDirectory() {
+    return path.join(os.homedir(), '.feique', 'logs');
+}
+export async function installServiceFile(options) {
+    const logDirectory = options.logDirectory ?? resolveDefaultLogDirectory();
+    const descriptor = buildServiceDescriptor({
+        ...options,
+        logDirectory,
+    });
+    await ensureDir(path.dirname(descriptor.targetPath));
+    await ensureDir(logDirectory);
+    await writeUtf8Atomic(descriptor.targetPath, descriptor.content);
+    return descriptor;
+}
+export async function uninstallServiceFile(options) {
+    const descriptor = buildServiceDescriptor({
+        serviceName: options.serviceName,
+        cliScriptPath: process.argv[1] ?? 'dist/cli.js',
+        nodeBinaryPath: process.execPath,
+        workingDirectory: process.cwd(),
+        logDirectory: resolveDefaultLogDirectory(),
+        platform: options.platform,
+    });
+    const exists = await fileExists(descriptor.targetPath);
+    if (exists) {
+        await fs.rm(descriptor.targetPath, { force: true });
+    }
+    return { removed: exists, targetPath: descriptor.targetPath };
+}
+//# sourceMappingURL=install.js.map

package/dist/service/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/service/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAA0B,MAAM,gBAAgB,CAAC;AAYhF,MAAM,UAAU,0BAA0B;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAA8B;IACrE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,0BAA0B,EAAE,CAAC;IAC1E,MAAM,UAAU,GAAG,sBAAsB,CAAC;QACxC,GAAG,OAAO;QACV,YAAY;KACb,CAAC,CAAC;IAEH,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IACrD,MAAM,SAAS,CAAC,YAAY,CAAC,CAAC;IAC9B,MAAM,eAAe,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACjE,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAA4D;IACrG,MAAM,UAAU,GAAG,sBAAsB,CAAC;QACxC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,aAAa;QAC/C,cAAc,EAAE,OAAO,CAAC,QAAQ;QAChC,gBAAgB,EAAE,OAAO,CAAC,GAAG,EAAE;QAC/B,YAAY,EAAE,0BAA0B,EAAE;QAC1C,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IACvD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,UAAU,EAAE,CAAC;AAChE,CAAC"}

package/dist/service/templates.d.ts

@@ -0,0 +1,22 @@
+export type ServicePlatform = 'darwin' | 'linux';
+export interface ServiceDescriptor {
+    platform: ServicePlatform;
+    serviceName: string;
+    targetPath: string;
+    content: string;
+    installHint: string;
+    uninstallHint: string;
+    startHint: string;
+    stopHint: string;
+    statusHint: string;
+}
+export interface ServiceTemplateInput {
+    serviceName: string;
+    cliScriptPath: string;
+    nodeBinaryPath: string;
+    workingDirectory: string;
+    configPath?: string;
+    logDirectory: string;
+    platform?: NodeJS.Platform;
+}
+export declare function buildServiceDescriptor(input: ServiceTemplateInput): ServiceDescriptor;

package/dist/service/templates.js

@@ -0,0 +1,118 @@
+import os from 'node:os';
+import path from 'node:path';
+export function buildServiceDescriptor(input) {
+    const platform = normalizePlatform(input.platform ?? process.platform);
+    if (platform === 'darwin') {
+        return buildLaunchdDescriptor(input);
+    }
+    if (platform === 'linux') {
+        return buildSystemdDescriptor(input);
+    }
+    throw new Error(`Unsupported platform: ${input.platform ?? process.platform}`);
+}
+function buildLaunchdDescriptor(input) {
+    const serviceName = input.serviceName;
+    const launchAgentPath = path.join(os.homedir(), 'Library', 'LaunchAgents', `${serviceName}.plist`);
+    const args = buildServeArgs(input);
+    const stdoutPath = path.join(input.logDirectory, `${serviceName}.out.log`);
+    const stderrPath = path.join(input.logDirectory, `${serviceName}.err.log`);
+    const content = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${escapeXml(serviceName)}</string>
+  <key>ProgramArguments</key>
+  <array>
+${args.map((arg) => `    <string>${escapeXml(arg)}</string>`).join('\n')}
+  </array>
+  <key>WorkingDirectory</key>
+  <string>${escapeXml(input.workingDirectory)}</string>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${escapeXml(stdoutPath)}</string>
+  <key>StandardErrorPath</key>
+  <string>${escapeXml(stderrPath)}</string>
+  <key>ProcessType</key>
+  <string>Interactive</string>
+</dict>
+</plist>
+`;
+    return {
+        platform: 'darwin',
+        serviceName,
+        targetPath: launchAgentPath,
+        content,
+        installHint: `launchctl bootstrap gui/$(id -u) ${shellQuote(launchAgentPath)}`,
+        uninstallHint: `launchctl bootout gui/$(id -u) ${shellQuote(launchAgentPath)} && rm -f ${shellQuote(launchAgentPath)}`,
+        startHint: `launchctl kickstart -k gui/$(id -u)/${serviceName}`,
+        stopHint: `launchctl bootout gui/$(id -u)/${serviceName}`,
+        statusHint: `launchctl print gui/$(id -u)/${serviceName}`,
+    };
+}
+function buildSystemdDescriptor(input) {
+    const serviceName = input.serviceName;
+    const unitPath = path.join(os.homedir(), '.config', 'systemd', 'user', `${serviceName}.service`);
+    const args = buildServeArgs(input).map(shellQuote).join(' ');
+    const stdoutPath = path.join(input.logDirectory, `${serviceName}.out.log`);
+    const stderrPath = path.join(input.logDirectory, `${serviceName}.err.log`);
+    const content = `[Unit]
+Description=飞鹊 (Feique)
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+WorkingDirectory=${input.workingDirectory}
+ExecStart=${args}
+Restart=always
+RestartSec=3
+StandardOutput=append:${stdoutPath}
+StandardError=append:${stderrPath}
+
+[Install]
+WantedBy=default.target
+`;
+    return {
+        platform: 'linux',
+        serviceName,
+        targetPath: unitPath,
+        content,
+        installHint: `systemctl --user daemon-reload && systemctl --user enable --now ${serviceName}.service`,
+        uninstallHint: `systemctl --user disable --now ${serviceName}.service && rm -f ${shellQuote(unitPath)} && systemctl --user daemon-reload`,
+        startHint: `systemctl --user start ${serviceName}.service`,
+        stopHint: `systemctl --user stop ${serviceName}.service`,
+        statusHint: `systemctl --user status ${serviceName}.service`,
+    };
+}
+function buildServeArgs(input) {
+    const args = [input.nodeBinaryPath, input.cliScriptPath, 'serve'];
+    if (input.configPath) {
+        args.push('--config', input.configPath);
+    }
+    return args;
+}
+function normalizePlatform(platform) {
+    if (platform === 'darwin' || platform === 'linux') {
+        return platform;
+    }
+    throw new Error(`Unsupported platform: ${platform}`);
+}
+function escapeXml(input) {
+    return input
+        .replaceAll('&', '&amp;')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;')
+        .replaceAll("'", '&apos;');
+}
+function shellQuote(input) {
+    if (/^[A-Za-z0-9_./:-]+$/.test(input)) {
+        return input;
+    }
+    return `'${input.replaceAll("'", `'"'"'`)}'`;
+}
+//# sourceMappingURL=templates.js.map