@qlingzzy/qling 1.0.0 → 1.1.1

package/dist/lsp/ts-service.js

@@ -0,0 +1,291 @@
+// ============================================================
+// Phase 4.3 — 可选 TypeScript LanguageService（进程内，非 stdio LSP）
+// 启用：QLING_LSP=1；依赖可选 peer/dev 的 typescript 包
+// ============================================================
+import { readFileSync, existsSync, statSync } from "fs";
+import { relative, resolve, extname } from "path";
+export function isLspEnabled(env = process.env) {
+    const raw = String(env.QLING_LSP ?? "").trim().toLowerCase();
+    return raw === "1" || raw === "true" || raw === "on" || raw === "yes";
+}
+export async function loadTypeScript() {
+    try {
+        const mod = await import("typescript");
+        return mod.default ?? mod;
+    }
+    catch {
+        return null;
+    }
+}
+function isTsLike(file) {
+    const ext = extname(file).toLowerCase();
+    return [".ts", ".tsx", ".js", ".jsx", ".mts", ".cts", ".mjs", ".cjs"].includes(ext);
+}
+function lineCharToPos(ts, content, line, character) {
+    // line/character 1-based for agent UX
+    const l = Math.max(1, line) - 1;
+    const c = Math.max(1, character) - 1;
+    return ts.getPositionOfLineAndCharacter(ts.createSourceFile("tmp.ts", content, ts.ScriptTarget.Latest, true), l, c);
+}
+function posToLineChar(ts, content, pos) {
+    const sf = ts.createSourceFile("tmp.ts", content, ts.ScriptTarget.Latest, true);
+    const lc = ts.getLineAndCharacterOfPosition(sf, pos);
+    return { line: lc.line + 1, character: lc.character + 1 };
+}
+const cache = new Map();
+function createLanguageService(ts, workspaceDir) {
+    const root = resolve(workspaceDir);
+    const configPath = ts.findConfigFile(root, ts.sys.fileExists.bind(ts.sys), "tsconfig.json");
+    let options = {
+        allowJs: true,
+        checkJs: false,
+        target: ts.ScriptTarget.ES2022,
+        module: ts.ModuleKind.ESNext,
+        moduleResolution: ts.ModuleResolutionKind.Bundler,
+        jsx: ts.JsxEmit.ReactJSX,
+        skipLibCheck: true,
+        esModuleInterop: true,
+    };
+    let rootFileNames = [];
+    if (configPath) {
+        const read = ts.readConfigFile(configPath, ts.sys.readFile.bind(ts.sys));
+        const parsed = ts.parseJsonConfigFileContent(read.config, ts.sys, resolve(configPath, ".."));
+        options = parsed.options;
+        rootFileNames = parsed.fileNames;
+    }
+    const fileExists = (f) => existsSync(f);
+    const readFile = (f) => {
+        try {
+            return readFileSync(f, "utf8");
+        }
+        catch {
+            return undefined;
+        }
+    };
+    // 确保打开的文件在 project 中
+    const extraFiles = new Set();
+    const host = {
+        getCompilationSettings: () => options,
+        getScriptFileNames: () => {
+            const set = new Set(rootFileNames);
+            for (const f of extraFiles)
+                set.add(f);
+            return Array.from(set);
+        },
+        getScriptVersion: (fileName) => {
+            try {
+                const stat = statSync(fileName);
+                return `${stat.mtimeMs}:${stat.size}`;
+            }
+            catch {
+                return "0";
+            }
+        },
+        getScriptSnapshot: (fileName) => {
+            const text = readFile(fileName);
+            if (text === undefined)
+                return undefined;
+            return ts.ScriptSnapshot.fromString(text);
+        },
+        getCurrentDirectory: () => root,
+        getDefaultLibFileName: (opts) => ts.getDefaultLibFilePath(opts),
+        fileExists,
+        readFile,
+        readDirectory: ts.sys.readDirectory,
+        directoryExists: ts.sys.directoryExists,
+        getDirectories: ts.sys.getDirectories,
+    };
+    const service = ts.createLanguageService(host, ts.createDocumentRegistry());
+    return {
+        ts,
+        service,
+        workspaceDir: root,
+        dispose: () => {
+            service.dispose();
+            cache.delete(root);
+        },
+    };
+}
+export function getTsService(ts, workspaceDir) {
+    const root = resolve(workspaceDir);
+    let bundle = cache.get(root);
+    if (!bundle) {
+        bundle = createLanguageService(ts, root);
+        cache.set(root, bundle);
+    }
+    return bundle;
+}
+export function resetTsServiceCache() {
+    for (const b of cache.values()) {
+        try {
+            b.service.dispose();
+        }
+        catch {
+            // ignore
+        }
+    }
+    cache.clear();
+}
+function rel(workspaceDir, abs) {
+    const r = relative(workspaceDir, abs).replace(/\\/g, "/");
+    return r || abs;
+}
+export function lspDefinition(bundle, absFile, line, character) {
+    const { ts, service, workspaceDir } = bundle;
+    if (!isTsLike(absFile) || !existsSync(absFile))
+        return [];
+    const content = readFileSync(absFile, "utf8");
+    const pos = lineCharToPos(ts, content, line, character);
+    const defs = service.getDefinitionAtPosition(absFile, pos) ?? [];
+    return defs.map((d) => {
+        const fileText = existsSync(d.fileName) ? readFileSync(d.fileName, "utf8") : "";
+        const lc = fileText
+            ? posToLineChar(ts, fileText, d.textSpan.start)
+            : { line: 1, character: 1 };
+        const preview = fileText
+            ? fileText.slice(d.textSpan.start, d.textSpan.start + Math.min(d.textSpan.length, 120))
+            : undefined;
+        return {
+            file: rel(workspaceDir, d.fileName),
+            line: lc.line,
+            character: lc.character,
+            preview: preview?.replace(/\s+/g, " ").trim(),
+        };
+    });
+}
+export function lspHover(bundle, absFile, line, character) {
+    const { ts, service } = bundle;
+    if (!isTsLike(absFile) || !existsSync(absFile))
+        return null;
+    const content = readFileSync(absFile, "utf8");
+    const pos = lineCharToPos(ts, content, line, character);
+    const info = service.getQuickInfoAtPosition(absFile, pos);
+    if (!info)
+        return null;
+    const display = ts.displayPartsToString(info.displayParts ?? []);
+    const documentation = ts.displayPartsToString(info.documentation ?? []);
+    return { display, documentation };
+}
+export function lspReferences(bundle, absFile, line, character, limit = 30) {
+    const { ts, service, workspaceDir } = bundle;
+    if (!isTsLike(absFile) || !existsSync(absFile))
+        return [];
+    const content = readFileSync(absFile, "utf8");
+    const pos = lineCharToPos(ts, content, line, character);
+    const refs = service.findReferences(absFile, pos)?.flatMap((r) => r.references) ?? [];
+    return refs.slice(0, limit).map((ref) => {
+        const fileText = existsSync(ref.fileName) ? readFileSync(ref.fileName, "utf8") : "";
+        const lc = fileText
+            ? posToLineChar(ts, fileText, ref.textSpan.start)
+            : { line: 1, character: 1 };
+        return {
+            file: rel(workspaceDir, ref.fileName),
+            line: lc.line,
+            character: lc.character,
+        };
+    });
+}
+export function lspDocumentSymbols(bundle, absFile, limit = 80) {
+    const { ts, service } = bundle;
+    if (!isTsLike(absFile) || !existsSync(absFile))
+        return [];
+    const nav = service.getNavigationBarItems(absFile);
+    const out = [];
+    const walk = (items, depth = 0) => {
+        for (const item of items) {
+            if (out.length >= limit)
+                return;
+            const span = item.spans[0];
+            if (span) {
+                const content = readFileSync(absFile, "utf8");
+                const lc = posToLineChar(ts, content, span.start);
+                out.push({
+                    name: item.text,
+                    kind: String(item.kind),
+                    line: lc.line,
+                    character: lc.character,
+                });
+            }
+            if (item.childItems?.length)
+                walk(item.childItems, depth + 1);
+        }
+    };
+    walk(nav);
+    return out;
+}
+/** 无 tsconfig 时：为单文件创建临时 service */
+export function getOrCreateServiceForFile(ts, workspaceDir, absFile) {
+    const root = resolve(workspaceDir);
+    const existing = cache.get(root);
+    if (existing)
+        return existing;
+    // 若有 tsconfig，正常创建
+    const configPath = ts.findConfigFile(root, ts.sys.fileExists.bind(ts.sys), "tsconfig.json");
+    if (configPath) {
+        return getTsService(ts, root);
+    }
+    // 单文件项目
+    const file = resolve(absFile);
+    const options = {
+        allowJs: true,
+        target: ts.ScriptTarget.ES2022,
+        module: ts.ModuleKind.ESNext,
+        moduleResolution: ts.ModuleResolutionKind.Bundler,
+        skipLibCheck: true,
+    };
+    const host = {
+        getCompilationSettings: () => options,
+        getScriptFileNames: () => [file],
+        getScriptVersion: () => {
+            try {
+                return String(statSync(file).mtimeMs);
+            }
+            catch {
+                return "0";
+            }
+        },
+        getScriptSnapshot: (fileName) => {
+            try {
+                return ts.ScriptSnapshot.fromString(readFileSync(fileName, "utf8"));
+            }
+            catch {
+                return undefined;
+            }
+        },
+        getCurrentDirectory: () => root,
+        getDefaultLibFileName: (opts) => ts.getDefaultLibFilePath(opts),
+        fileExists: (f) => existsSync(f),
+        readFile: (f) => {
+            try {
+                return readFileSync(f, "utf8");
+            }
+            catch {
+                return undefined;
+            }
+        },
+        readDirectory: ts.sys.readDirectory,
+        directoryExists: ts.sys.directoryExists,
+        getDirectories: ts.sys.getDirectories,
+    };
+    const service = ts.createLanguageService(host, ts.createDocumentRegistry());
+    const bundle = {
+        ts,
+        service,
+        workspaceDir: root,
+        dispose: () => {
+            service.dispose();
+            cache.delete(root + "::" + file);
+        },
+    };
+    // 使用 workspace key 仍可能冲突；用 root 即可覆盖无 tsconfig 场景
+    cache.set(root, bundle);
+    return bundle;
+}
+export function resolveAbsFile(workspaceDir, filePath) {
+    if (!filePath)
+        return "";
+    if (existsSync(filePath) && (filePath.includes("/") || filePath.includes("\\") || /^[A-Za-z]:/.test(filePath))) {
+        return resolve(filePath);
+    }
+    return resolve(workspaceDir, filePath);
+}

package/dist/memory/lifecycle.d.ts

@@ -0,0 +1,19 @@
+import type { Message } from "../types.js";
+import { MemoryStore } from "../memory.js";
+export interface AutoDreamOptions {
+    messages: Message[];
+    turnCount: number;
+    memoryStore: MemoryStore;
+    memoryDreamLLMEnabled: boolean;
+    memoryDreamTurnThreshold: number;
+    memoryMaxEntries: number;
+    model: string;
+    apiKey: string;
+    endpoint: string;
+}
+/**
+ * Run one auto-dream pass. Returns number of changed memory entries.
+ * Failures are swallowed by the caller if desired; this function rethrows only unexpected errors.
+ */
+export declare function runAutoDream(options: AutoDreamOptions): Promise<number>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/memory/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/memory/lifecycle.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAwB,MAAM,cAAc,CAAC;AAGjE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkD7E"}

package/dist/memory/lifecycle.js

@@ -0,0 +1,53 @@
+// ============================================================
+// 记忆生命周期（从 AgentLoop 抽出）：auto-dream 整理
+// domain 层 — 不依赖 agent-loop / TUI / CLI
+// ============================================================
+import { extractDreamMemories } from "../memory.js";
+import { extractDreamMemoriesLLM } from "./memory-llm-dream.js";
+/**
+ * Run one auto-dream pass. Returns number of changed memory entries.
+ * Failures are swallowed by the caller if desired; this function rethrows only unexpected errors.
+ */
+export async function runAutoDream(options) {
+    const transcript = options.messages
+        .filter((m) => m.role === "user" || m.role === "assistant")
+        .map((m) => m.content);
+    let memories;
+    let changedCount = 0;
+    if (options.memoryDreamLLMEnabled) {
+        memories = await extractDreamMemoriesLLM(transcript, options.turnCount, {
+            enabled: true,
+            model: options.model,
+            maxTokens: 300,
+            apiKey: options.apiKey,
+            endpoint: options.endpoint || "https://api.deepseek.com",
+        });
+        const { consolidateMemoriesLLM } = await import("./consolidation.js");
+        const existing = options.memoryStore.exportPersisted();
+        const ops = await consolidateMemoriesLLM(memories, existing, {
+            apiKey: options.apiKey,
+            endpoint: options.endpoint || "https://api.deepseek.com",
+            model: options.model,
+        });
+        options.memoryStore.applyOperations(ops, "workspace");
+        changedCount = ops.filter((op) => op.action !== "NOOP").length;
+    }
+    else {
+        memories = await extractDreamMemories({ turnCount: options.turnCount, transcript }, {
+            enabled: true,
+            turnThreshold: options.memoryDreamTurnThreshold,
+            transcriptWindow: 4,
+        });
+        const existingContents = new Set(options.memoryStore.exportPersisted().map((e) => e.content));
+        const newMems = memories.filter((m) => !existingContents.has(m));
+        for (const mem of newMems) {
+            options.memoryStore.add(mem, "auto-dream", 0.6);
+        }
+        changedCount = newMems.length;
+    }
+    if (changedCount > 0) {
+        options.memoryStore.compactPersisted(options.memoryMaxEntries);
+        await options.memoryStore.saveToDisk();
+    }
+    return changedCount;
+}

package/dist/memory.d.ts

@@ -129,21 +129,5 @@ interface DreamConfig {
     transcriptWindow?: number;
 }
 export declare function extractDreamMemories(ctx: DreamContext, config: DreamConfig): Promise<string[]>;
-export declare class TokenBudgetManager {
-    maxTokens: number;
-    nudgeThreshold: number;
-    usedTokens: number;
-    constructor(maxTokens: number, nudgeThreshold?: number, usedTokens?: number);
-    addUsage(tokens: number): void;
-    syncUsage(actualTokens: number): void;
-    reset(): void;
-    getRemaining(): number;
-    getRemainingPct(): number;
-    shouldNudge(): boolean;
-    buildNudgeMessage(): string;
-    estimateMessagesCost(messages: {
-        content: string;
-    }[]): number;
-}
 export {};
 //# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

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

package/dist/memory.js

@@ -594,39 +594,3 @@ export async function extractDreamMemories(ctx, config) {
     }
     return Array.from(new Set(memories));
 }
-// --- Token Budget Manager ---
-export class TokenBudgetManager {
-    maxTokens;
-    nudgeThreshold;
-    usedTokens;
-    constructor(maxTokens, nudgeThreshold = 0.2, usedTokens = 0) {
-        this.maxTokens = maxTokens;
-        this.nudgeThreshold = nudgeThreshold;
-        this.usedTokens = usedTokens;
-    }
-    addUsage(tokens) {
-        this.usedTokens += tokens;
-    }
-    syncUsage(actualTokens) {
-        this.usedTokens = actualTokens;
-    }
-    reset() {
-        this.usedTokens = 0;
-    }
-    getRemaining() {
-        return this.maxTokens - this.usedTokens;
-    }
-    getRemainingPct() {
-        return this.getRemaining() / this.maxTokens;
-    }
-    shouldNudge() {
-        return this.getRemainingPct() < this.nudgeThreshold;
-    }
-    buildNudgeMessage() {
-        const pct = Math.round(this.getRemainingPct() * 100);
-        return "Token 预算即将耗尽（剩余 " + pct + "%），请精简回复，减少工具调用频率。";
-    }
-    estimateMessagesCost(messages) {
-        return messages.reduce((sum, m) => sum + m.content.length * 4, 0);
-    }
-}

package/dist/metrics/collector.d.ts

@@ -9,6 +9,13 @@ export declare class MetricsCollector {
     record(event: Omit<MetricEvent, "ts" | "session_id">): void;
     flush(): Promise<void>;
     query(query: MetricsQuery): Promise<MetricEvent[]>;
+    queryRecent(options: MetricsQuery & {
+        maxScanBytes?: number;
+    }): Promise<{
+        events: MetricEvent[];
+        scannedBytes: number;
+        truncated: boolean;
+    }>;
     startAutoFlush(): ReturnType<typeof setInterval>;
     stopAutoFlush(timer: ReturnType<typeof setInterval>): void;
     purgeOldEntries(retentionDays: number): Promise<number>;

package/dist/metrics/collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/metrics/collector.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAS;gBAEpB,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAE,MAAe;IAM7E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,YAAY,CAAC,GAAG,IAAI;IAYrD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBtB,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA6BxD,cAAc,IAAI,UAAU,CAAC,OAAO,WAAW,CAAC;IAMhD,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,IAAI;IAIpD,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuC7D,OAAO,CAAC,YAAY;CAOrB"}
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/metrics/collector.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAS;gBAEpB,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAE,MAAe;IAM7E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,YAAY,CAAC,GAAG,IAAI;IAYrD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBtB,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA6BlD,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG;QACxC,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IA6DhF,cAAc,IAAI,UAAU,CAAC,OAAO,WAAW,CAAC;IAMhD,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,IAAI;IAIpD,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuC7D,OAAO,CAAC,YAAY;CAOrB"}

package/dist/metrics/collector.js

@@ -75,6 +75,66 @@ export class MetricsCollector {
             return results.slice(0, query.limit);
         return results;
     }
+    async queryRecent(options) {
+        const limit = Math.min(100, Math.max(1, Math.floor(options.limit ?? 20)));
+        const maxScanBytes = Math.min(8 * 1024 * 1024, Math.max(1024, Math.floor(options.maxScanBytes ?? 1024 * 1024)));
+        const events = this.buffer
+            .filter((event) => this.matchesQuery(event, options))
+            .sort((a, b) => b.ts - a.ts);
+        let scannedBytes = 0;
+        let truncated = false;
+        if (events.length < limit && fsSync.existsSync(this.metricsDir)) {
+            const files = (await fs.readdir(this.metricsDir))
+                .filter((file) => file.startsWith("metrics-") && file.endsWith(".jsonl"))
+                .sort()
+                .reverse();
+            for (const file of files) {
+                if (events.length >= limit || scannedBytes >= maxScanBytes)
+                    break;
+                const filePath = path.join(this.metricsDir, file);
+                const stat = await fs.stat(filePath);
+                const bytesToRead = Math.min(stat.size, maxScanBytes - scannedBytes);
+                if (bytesToRead <= 0)
+                    break;
+                const start = Math.max(0, stat.size - bytesToRead);
+                const handle = await fs.open(filePath, "r");
+                try {
+                    const buffer = Buffer.alloc(bytesToRead);
+                    const { bytesRead } = await handle.read(buffer, 0, bytesToRead, start);
+                    scannedBytes += bytesRead;
+                    let text = buffer.subarray(0, bytesRead).toString("utf-8");
+                    if (start > 0) {
+                        const firstBreak = text.indexOf("\n");
+                        text = firstBreak >= 0 ? text.slice(firstBreak + 1) : "";
+                        truncated = true;
+                    }
+                    const lines = text.split(/\r?\n/).filter(Boolean).reverse();
+                    for (const line of lines) {
+                        if (events.length >= limit)
+                            break;
+                        try {
+                            const event = JSON.parse(line);
+                            if (this.matchesQuery(event, options))
+                                events.push(event);
+                        }
+                        catch {
+                            // Ignore incomplete or invalid JSONL records.
+                        }
+                    }
+                }
+                finally {
+                    await handle.close();
+                }
+            }
+            if (scannedBytes >= maxScanBytes)
+                truncated = true;
+        }
+        return {
+            events: events.sort((a, b) => b.ts - a.ts).slice(0, limit),
+            scannedBytes,
+            truncated,
+        };
+    }
     startAutoFlush() {
         return setInterval(() => {
             this.flush().catch(() => { });

package/dist/mission/manager.d.ts

@@ -11,6 +11,7 @@ export declare class MissionManager {
     getMission(id: string): Mission | undefined;
     getMissionOrThrow(id: string): Mission;
     listMissions(): Mission[];
+    refresh(): Promise<void>;
     getMissionLogs(id: string): Promise<MissionEvent[]>;
     appendLog(id: string, message: string, meta?: Record<string, unknown>): Promise<void>;
     pauseMission(id: string, reason?: string): Promise<Mission>;

package/dist/mission/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/mission/manager.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAKlE,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAmC;gBAEvC,QAAQ,EAAE,MAAM;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAO,GACzC,OAAO,CAAC,OAAO,CAAC;IAmCb,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,aAAa,EACrB,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,EACxB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,OAAO,CAAC;IA2BnB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI3C,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQtC,YAAY,IAAI,OAAO,EAAE;IAKnB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAanD,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAezF,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3D,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5D,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB5D,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAyBlC,WAAW;YAKX,YAAY;IAe1B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,YAAY;YAIN,WAAW;YAKX,sBAAsB;IAiCpC,OAAO,CAAC,kBAAkB;CAM3B"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/mission/manager.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAMlE,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAmC;gBAEvC,QAAQ,EAAE,MAAM;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAO,GACzC,OAAO,CAAC,OAAO,CAAC;IAmCb,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,aAAa,EACrB,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,EACxB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,OAAO,CAAC;IA6BnB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI3C,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQtC,YAAY,IAAI,OAAO,EAAE;IAKnB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAanD,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBzF,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3D,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5D,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB5D,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAyBlC,WAAW;YAKX,YAAY;IAe1B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,YAAY;YAIN,WAAW;YAKX,sBAAsB;IAiCpC,OAAO,CAAC,kBAAkB;CAM3B"}

package/dist/mission/manager.js

@@ -5,6 +5,7 @@
 import * as fs from "fs/promises";
 import * as path from "path";
 import { existsSync } from "fs";
+import { notifyMissionLog, notifyMissionProgress } from "./progress-notify.js";
 const TERMINAL_STATUSES = new Set(["succeeded", "failed", "canceled"]);
 const PAUSABLE_STATUSES = new Set(["queued", "running", "blocked"]);
 export class MissionManager {
@@ -77,6 +78,8 @@ export class MissionManager {
                 ...meta,
             },
         });
+        // Phase 3.5: 可选 Telegram/Slack 进度推送（失败不阻断使命）
+        void notifyMissionProgress(mission, previousStatus, status).catch(() => undefined);
         return mission;
     }
     getMission(id) {
@@ -93,6 +96,10 @@ export class MissionManager {
         return Array.from(this.missions.values())
             .sort((a, b) => b.createdAt - a.createdAt);
     }
+    async refresh() {
+        this.missions.clear();
+        await this.loadMissions();
+    }
     async getMissionLogs(id) {
         this.getMissionOrThrow(id);
         const filePath = this.getEventPath(id);
@@ -118,6 +125,8 @@ export class MissionManager {
                 ...meta,
             },
         });
+        // 里程碑日志可选推送（QLING_MISSION_NOTIFY_LOGS，默认 milestone）
+        void notifyMissionLog(mission, message).catch(() => undefined);
     }
     async pauseMission(id, reason) {
         return this.applyControlTransition(id, "pause", "paused", PAUSABLE_STATUSES, reason);

package/dist/mission/progress-notify.d.ts

@@ -0,0 +1,39 @@
+import type { Mission, MissionStatus } from "./types.js";
+export type MissionNotifyEnv = NodeJS.ProcessEnv | Record<string, string | undefined>;
+export declare function isMissionNotifyEnabled(env?: MissionNotifyEnv): boolean;
+export declare function resolveNotifyStyle(env?: MissionNotifyEnv): "plain" | "rich";
+/** 使命日志推送策略：off | milestone（默认）| all */
+export type MissionLogNotifyMode = "off" | "milestone" | "all";
+export declare function resolveMissionLogNotifyMode(env?: MissionNotifyEnv): MissionLogNotifyMode;
+/**
+ * 是否应对本条使命日志发通道通知。
+ */
+export declare function shouldNotifyMissionLog(message: string, env?: MissionNotifyEnv): boolean;
+export declare function formatMissionLogMessage(mission: Pick<Mission, "id" | "name" | "status">, message: string): string;
+export declare function statusEmoji(status: MissionStatus): string;
+export declare function formatMissionProgressMessage(mission: Pick<Mission, "id" | "name" | "description" | "status" | "error">, from: MissionStatus | null, to: MissionStatus): string;
+/** Telegram HTML（需 escape） */
+export declare function formatMissionProgressTelegramHtml(mission: Pick<Mission, "id" | "name" | "description" | "status" | "error">, from: MissionStatus | null, to: MissionStatus): string;
+/** Slack Block Kit 最小卡片 */
+export declare function formatMissionProgressSlackBlocks(mission: Pick<Mission, "id" | "name" | "description" | "status" | "error">, from: MissionStatus | null, to: MissionStatus): {
+    text: string;
+    blocks: unknown[];
+};
+export interface NotifyDispatchResult {
+    attempted: boolean;
+    telegram: "sent" | "skipped" | "error";
+    slack: "sent" | "skipped" | "error";
+    detail: string;
+    style: "plain" | "rich";
+}
+export declare function assertSlackResponseOk(data: unknown): void;
+/**
+ * 向已配置的 Telegram / Slack 发送使命进度（失败不抛出）。
+ */
+export declare function notifyMissionProgress(mission: Mission, from: MissionStatus | null, to: MissionStatus, env?: MissionNotifyEnv): Promise<NotifyDispatchResult>;
+/**
+ * 使命日志推送（默认仅里程碑；失败不抛出）。
+ * QLING_MISSION_NOTIFY_LOGS=off|milestone|all
+ */
+export declare function notifyMissionLog(mission: Mission, message: string, env?: MissionNotifyEnv): Promise<NotifyDispatchResult>;
+//# sourceMappingURL=progress-notify.d.ts.map

package/dist/mission/progress-notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-notify.d.ts","sourceRoot":"","sources":["../../src/mission/progress-notify.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEtF,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,gBAA8B,GAAG,OAAO,CAInF;AAED,wBAAgB,kBAAkB,CAChC,GAAG,GAAE,gBAA8B,GAClC,OAAO,GAAG,MAAM,CAGlB;AAED,wCAAwC;AACxC,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,WAAW,GAAG,KAAK,CAAC;AAE/D,wBAAgB,2BAA2B,CACzC,GAAG,GAAE,gBAA8B,GAClC,oBAAoB,CAKtB;AAKD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,gBAA8B,GAClC,OAAO,CAMT;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC,EAChD,OAAO,EAAE,MAAM,GACd,MAAM,CASR;AAYD,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAEzD;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC,EAC1E,IAAI,EAAE,aAAa,GAAG,IAAI,EAC1B,EAAE,EAAE,aAAa,GAChB,MAAM,CAiBR;AAED,8BAA8B;AAC9B,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC,EAC1E,IAAI,EAAE,aAAa,GAAG,IAAI,EAC1B,EAAE,EAAE,aAAa,GAChB,MAAM,CAmBR;AAED,2BAA2B;AAC3B,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC,EAC1E,IAAI,EAAE,aAAa,GAAG,IAAI,EAC1B,EAAE,EAAE,aAAa,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAA;CAAE,CAqCrC;AAaD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;CACzB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CASzD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,aAAa,GAAG,IAAI,EAC1B,EAAE,EAAE,aAAa,EACjB,GAAG,GAAE,gBAA8B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CA0H/B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,gBAA8B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CA8H/B"}