qlogicagent 2.19.12 → 2.19.13

package/dist/types/cli/handlers/memory-handler.d.ts

@@ -1,6 +1,8 @@
 /**
- * Memory CRUD + search handlers extracted from StdioServer.
- * Handles: memory.list, memory.read, memory.write, memory.search, memory.delete
+ * Agent-resident memory brain-compute handlers. Handles: memory.propose (LLM candidate
+ * extraction) and memory.search (hybrid retrieval with a memdir fallback). The store/library
+ * and memdir file-face methods are Runtime Host-native (gateway MemoryProfileService + memdir
+ * file face) and were removed here — see rpc-registry.memory-cut.test.ts.
  */
 import { type AgentRpcError, type AgentRpcRequest } from "../../protocol/wire/index.js";
 import type { MemoryHandlerProvider, ProjectMemoryStore, ProjectMemoryStoreFactory } from "../../runtime/ports/index.js";
@@ -29,39 +31,6 @@ export interface MemoryHandlerHost {
     sendNotification(method: string, params: Record<string, unknown>): void;
     sendResponse(id: string | number, result?: unknown, error?: AgentRpcError): void;
 }
-export declare function handleMemoryList(this: MemoryHandlerHost, msg: AgentRpcRequest): Promise<void>;
-/** memory.list-files: returns actual topic files from memdir. */
-export declare function handleMemoryListFiles(this: MemoryHandlerHost, msg: AgentRpcRequest): Promise<void>;
-/**
- * memory.proposals: pending factual proposals (implicit-extract / feedback /
- * dream) awaiting corroboration — the candidate surface of the proposal
- * consumer. action=list (default) returns them; action=confirm/dismiss
- * resolves one (confirm commits with manual authority; dismiss rejects).
- */
-export declare function handleMemoryProposals(this: MemoryHandlerHost, msg: AgentRpcRequest): Promise<void>;
-/**
- * memory.atlas: returns full L2 vector-memory records (wire-safe, no embedding
- * blob) plus category roll-ups, for the 3D memory atlas visualization.
- */
-export declare function handleMemoryAtlas(this: MemoryHandlerHost, msg: AgentRpcRequest): Promise<void>;
-/**
- * memory.activity: daily activity counts + highlights over the recent window,
- * powering the atlas timeline ticks and the "memory digest" panel.
- */
-export declare function handleMemoryActivity(this: MemoryHandlerHost, msg: AgentRpcRequest): Promise<void>;
 export declare function handleMemoryPropose(this: MemoryHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleMemoryConsolidate(this: MemoryHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleMemoryRead(this: MemoryHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleMemoryWrite(this: MemoryHandlerHost, msg: AgentRpcRequest): Promise<void>;
 export declare function handleMemorySearch(this: MemoryHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleMemoryDelete(this: MemoryHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleMemoryUpdate(this: MemoryHandlerHost, msg: AgentRpcRequest): Promise<void>;
-/**
- * memory.attachment.adopt: persist an uploaded attachment into the long-term-memory
- * attachment store from a transient source URL (the gateway's temp MediaStore).
- * The attachment is an orphan until linked to a memory at consolidate time.
- */
-export declare function handleMemoryAttachmentAdopt(this: MemoryHandlerHost, msg: AgentRpcRequest): Promise<void>;
-/** memory.attachment.locate: resolve an attachment id to its on-disk path (for serving). */
-export declare function handleMemoryAttachmentLocate(this: MemoryHandlerHost, msg: AgentRpcRequest): Promise<void>;
 export {};

package/dist/types/cli/rpc-registry.d.ts

@@ -32,10 +32,10 @@ export type RpcMethodHandler = (msg: AgentRpcRequest) => void | Promise<void>;
  */
 export interface TaskDistillationRpcSurface {
     runPass(reason: "manual"): Promise<object>;
-    listProposals(): unknown[];
-    dismissProposal(id: string): boolean;
-    acknowledgeProposal(id: string): boolean;
-    getMetrics(): object;
+    listProposals(): Promise<unknown[]>;
+    dismissProposal(id: string): Promise<boolean>;
+    acknowledgeProposal(id: string): Promise<boolean>;
+    getMetrics(): Promise<object>;
     promote(id: string): Promise<object>;
     demote(id: string): Promise<object>;
 }

package/dist/types/cli/task-distillation-coordinator.d.ts

@@ -7,8 +7,10 @@
  *     LLM 摘要(dream 同款小模型)失败时降级确定性模板 —— 蒸馏永不因模型不可用而丢样本。
  *   · 晋升(spec:唯一技能入口): accessCount ≥ 阈值且未被负反馈沉底 → system.activity 推荐。
  */
-import { type PromotionMetrics, type CandidateStoreFile, type PromotionProposal } from "../skills/memory/task-distillation.js";
+import { type PromotionMetrics, type CandidateStoreFile, type PromotionProposal, type ProcedureUsageStoreFile, type PromotionStoreFile } from "../skills/memory/task-distillation.js";
 import type { HostCapabilityClient } from "../transport/host-capability-client.js";
+/** [A4] addProcedure 落库回执分类(见 TaskDistillationDeps.addProcedure)。 */
+export type AddProcedureOutcome = "created" | "merged" | "rejected" | "retryable-failure";
 export interface TaskDistillationDeps {
     profileMemoryDir: () => string;
     /** Gateway-owned skill authority. Missing service is fatal; local skill-store fallback is forbidden. */
@@ -16,8 +18,12 @@ export interface TaskDistillationDeps {
     /** 签名 embedding;null=不可用(候选照存但不参与聚类,宁严勿松)。
      * B3(X7):number[](非 Float32Array)——host 模式下 embedText 结果跨 x/host.request JSON wire。 */
     embed: (text: string) => Promise<number[] | null>;
-    /** 落库:返回是否成功(候选只在成功后标 distilled) */
-    addProcedure: (text: string, tags: string[]) => Promise<boolean>;
+    /** [A4] 落库回执四分类(由 ingestExtracted 的结构化 items 归并):
+     *   created  = 真实新落库 → 标 distilled + 发通知(只有它发);
+     *   merged   = 近重复合并/已入提案管道 —— 合法成功,标 distilled 不通知;
+     *   rejected = 安全闸拒/冲突 —— 终态,候选标 rejected 不再重试;
+     *   retryable-failure = RPC 抛错/环境未就绪 —— 候选保持 pending 等下轮。 */
+    addProcedure: (text: string, tags: string[]) => Promise<AddProcedureOutcome>;
     /** 小模型摘要(dream 同款);null/失败 → 降级模板 */
     llmExtract?: (prompt: string) => Promise<string | null>;
     /** 晋升扫描数据源:全部 distilled 条目 {id,text,accessCount,importance} */
@@ -27,8 +33,37 @@ export interface TaskDistillationDeps {
         accessCount: number;
         importance: number;
     }>>;
-    /** V3 promote/demote:archive(技能接棒)/unarchive(降格回归)。B3(X7)异步化:16 面 proxy 方法。 */
+    /** V3 promote/demote:archive(技能接棒)/unarchive(降格回归)。B3(X7)异步化:16 面 proxy 方法。
+     * [A10] 后仅 demote 侧消费(promote 三步已收归 Host saga)。 */
     setMemoryArchived: (id: string, archived: boolean) => Promise<boolean>;
+    /** [A10] 升格窄 Saga(Host 协调,memory proxy promoteDistilledProcedure):
+     * create+verify → archive → proposal accepted,幂等/补偿/续跑在 Host;
+     * 大脑传入推理产物(渲染并校验过的 SKILL.md 全文、确定性 skillName、标题/计数/auto)。 */
+    promoteProcedure: (input: {
+        procedureId: string;
+        skillName: string;
+        content: string;
+        title: string;
+        accessCount: number;
+        auto: boolean;
+    }) => Promise<{
+        outcome: "completed" | "already-completed";
+        skillName: string;
+        steps: {
+            skillCreated: boolean;
+            memoryArchived: boolean;
+            proposalAccepted: boolean;
+        };
+    }>;
+    /** [X7] procedure-usage.json 读:store-owner 归 gateway,经 x/host proxy(自动档跨-session 数据源)。 */
+    readProcedureUsage: () => Promise<ProcedureUsageStoreFile>;
+    /** [X7] task-distill-candidates.json 读/写:store-owner 归 gateway;大脑侧裁剪(capCandidateStore)后经 proxy 写。 */
+    readCandidates: () => Promise<CandidateStoreFile>;
+    writeCandidates: (store: CandidateStoreFile) => Promise<void>;
+    /** [X7] promotion-proposals.json 读/写:晋升生命周期大脑逻辑留 qla,store-owner 归 gateway
+     *  (gateway ActionSurface 也读同一文件;写者唯一=gateway 经此 proxy)。 */
+    readProposals: () => Promise<PromotionStoreFile>;
+    writeProposals: (store: PromotionStoreFile) => Promise<void>;
     sendNotification: (method: string, params: Record<string, unknown>) => void;
     log: (message: string) => void;
 }
@@ -59,14 +94,17 @@ export declare class TaskDistillationCoordinator {
     /** 晋升扫描(spec:技能的唯一产生入口):复用达标且未被负反馈沉底 → 写持久提议。
      * V3.1:提议是持久待办(promotion-proposals.json),UI 双入口消费;activity 仅作日志。 */
     private scanPromotions;
-    listProposals(): PromotionProposal[];
+    listProposals(): Promise<PromotionProposal[]>;
     /** V3.2 仪表(接受率/降格率/自动档解锁态);技能激活计数由 skill-lifecycle useCount 承载。 */
-    getMetrics(): PromotionMetrics;
+    getMetrics(): Promise<PromotionMetrics>;
     /** 自动升格开场确认卡「知道了」。 */
-    acknowledgeProposal(procedureId: string): boolean;
-    dismissProposal(procedureId: string): boolean;
-    /** 升格执行链:配方→SKILL.md(LLM 格式转换,降级模板)→落盘+lifecycle(默认启用)
-     * →procedure archive(技能接棒,拍板①)→proposal accepted。 */
+    acknowledgeProposal(procedureId: string): Promise<boolean>;
+    dismissProposal(procedureId: string): Promise<boolean>;
+    /** 升格:大脑只做推理半程(找配方→渲染 SKILL.md→写盘前校验→确定性命名),
+     * [A10] 三步执行(create+verify→archive→proposal accepted)收归 Host 窄 Saga ——
+     * 它横跨 Capability/Memory 两个 Host 存储,幂等(procedureId+确定性 skillName)、
+     * 逐步补偿、崩溃续跑都在 Host;旧实现 create 之后的两步无 catch 无补偿,
+     * 该窗口失败即双向死角(重跑撞 already exists,demote 缺 skillName 找不到目标)。 */
     promote(procedureId: string, opts?: {
         auto?: boolean;
     }): Promise<{
@@ -81,4 +119,3 @@ export declare class TaskDistillationCoordinator {
     }>;
     private renderSkillMarkdown;
 }
-export declare function buildCandidateStoreSnapshot(profileMemoryDir: string): CandidateStoreFile;

package/dist/types/contracts/error-category.d.ts

@@ -0,0 +1,11 @@
+/** Every category classifyError can produce. The ErrorCategory type is
+ * derived from this array, so the runtime guard below can never drift
+ * from the type union. */
+export declare const ERROR_CATEGORIES: readonly ["RETRYABLE_TRANSIENT", "RETRYABLE_DEGRADED", "NON_RETRYABLE_AUTH", "NON_RETRYABLE_CONTENT", "NON_RETRYABLE_QUOTA", "TOOL_EXECUTION_FAILED"];
+export type ErrorCategory = (typeof ERROR_CATEGORIES)[number];
+/** Runtime guard: is this string one of classifyError's categories?
+ * turn.failed also carries codes from OUTSIDE this vocabulary (stream codes
+ * like PROVIDER_STREAM_ERROR / LLM_STREAM_TIMEOUT / PROMPT_TOO_LONG, or
+ * ABORTED) — consumers use this to tell them apart. */
+export declare function isErrorCategory(value: unknown): value is ErrorCategory;
+export declare function isRetryableCategory(category: ErrorCategory): boolean;

package/dist/types/host-contract/index.d.ts

@@ -803,7 +803,7 @@ export interface HostNotificationSink {
  * [X7] qlogicagent 大脑经 x/host.request 可调用的 memory proxy 精确方法面。
  * gateway 白名单与 qla HostMemoryProvider 都必须直接消费此常量，禁止两仓手抄后漂移。
  */
-export declare const HOST_MEMORY_PROXY_METHODS: readonly ["search", "addText", "embedText", "ingestExtracted", "proposeExtracted", "consumePendingProposals", "feedback", "findRelatedEvents", "synthesizeTimeline", "getActivitySummary", "getAllProfiles", "setProfile", "getAtlas", "setMemoryArchived", "triggerDecay", "resolveConflicts"];
+export declare const HOST_MEMORY_PROXY_METHODS: readonly ["search", "addText", "embedText", "ingestExtracted", "proposeExtracted", "consumePendingProposals", "feedback", "findRelatedEvents", "synthesizeTimeline", "getActivitySummary", "getAllProfiles", "setProfile", "getAtlas", "setMemoryArchived", "triggerDecay", "resolveConflicts", "readProcedureUsage", "writeProcedureUsage", "readDistillCandidates", "writeDistillCandidates", "readPromotionProposals", "writePromotionProposals", "listActiveMemoriesByTag", "promoteDistilledProcedure"];
 export type HostMemoryProxyMethod = (typeof HOST_MEMORY_PROXY_METHODS)[number];
 /** Project-scoped Markdown memory face. Gateway resolves cwd/project from the supervised caller. */
 export declare const HOST_PROJECT_MEMORY_PROXY_METHODS: readonly ["initialize", "getIndex", "addToIndex", "replaceInIndex", "removeFromIndex", "createFile", "writeFile", "readFile", "deleteFile", "listFiles", "searchLocal"];

package/dist/types/orchestration/error-handling/error-classification.d.ts

@@ -1,3 +1,3 @@
-export type ErrorCategory = "RETRYABLE_TRANSIENT" | "RETRYABLE_DEGRADED" | "NON_RETRYABLE_AUTH" | "NON_RETRYABLE_CONTENT" | "NON_RETRYABLE_QUOTA" | "TOOL_EXECUTION_FAILED";
+import type { ErrorCategory } from "../../contracts/error-category.js";
+export { ERROR_CATEGORIES, isErrorCategory, isRetryableCategory, type ErrorCategory, } from "../../contracts/error-category.js";
 export declare function classifyError(status: number | undefined, message?: string): ErrorCategory;
-export declare function isRetryableCategory(category: ErrorCategory): boolean;

package/dist/types/runtime/execution/dream-agent.d.ts

@@ -69,10 +69,20 @@ export interface DreamRunResult {
  * Allowed:
  *   - read_file, grep, glob, search — unrestricted read-only tools
  *   - bash — only read-only commands (ls, grep, cat, find, stat, wc, head, tail)
- *   - file_edit, file_write — only within memoryRoot
+ *   - memory — the memdir writer (routes through the gateway projectMemory proxy)
+ *   - raw write/edit/patch — denied (memory writes must go through the `memory` tool)
  *   - Everything else — denied
  */
 export declare function canUseDreamTool(memoryRoot: string, restriction: DreamToolRestriction): DreamToolVerdict;
+/**
+ * Canonical catalog tool names advertised to the dream sub-agent. This trims the
+ * full manifest (dozens of irrelevant tools) down to what dream actually uses.
+ * Every name here MUST be allowed by canUseDreamTool — raw write/edit/patch are
+ * intentionally absent (canUseDreamTool hard-denies them); the `memory` tool is
+ * the sole sanctioned memdir writer and routes through the gateway proxy
+ * (dream-memdir-migration).
+ */
+export declare const DREAM_ALLOWED_TOOLS: Set<string>;
 /**
  * Build the 4-phase memory consolidation prompt.
  *

package/dist/types/runtime/infra/llmrouter-managed-inference.d.ts

@@ -1,6 +1,6 @@
 import type { ConfigPort } from "../ports/index.js";
 export interface ManagedInferenceRequest {
-    path: "/v1/models" | "/v1/files" | `/v1/files/${string}` | "/v1/cad/plan-grants";
+    path: "/v1/models" | "/v1/files" | `/v1/files/${string}` | "/v1/cad/plan-grants" | "/v1/solidworks/plan-grants";
     method: "GET" | "POST" | "DELETE";
     contentType?: string;
     body?: AsyncIterable<Uint8Array>;

package/dist/types/runtime/memory/find-relevant-memories.d.ts

@@ -1,36 +1,9 @@
 export declare const RELEVANT_MEMORIES_CONFIG: {
-    /** Max topic files to consider during scan. */
-    readonly MAX_SCAN_FILES: 100;
     /** Max files to surface per turn. */
     readonly MAX_SELECTED: 5;
     /** Max bytes per surfaced file (CC: 4096). */
     readonly MAX_FILE_BYTES: 4096;
-    /** Max total bytes for all surfaced files combined. */
-    readonly MAX_TOTAL_BYTES: number;
-    /** Minimum score to be selected (0.0-1.0). */
-    readonly MIN_SCORE: 0.2;
-    /** Lines to read for header/description extraction. */
-    readonly HEADER_LINES: 10;
-    /** Recency boost: files modified within this many days get a bonus. */
-    readonly RECENCY_DAYS: 7;
-    /** Recency boost amount. */
-    readonly RECENCY_BOOST: 0.15;
 };
-/** Scanned memory file header (CC MemoryHeader parity). */
-export interface MemoryFileHeader {
-    /** Filename (e.g. "lesson-docker.md") */
-    filename: string;
-    /** Absolute path */
-    filePath: string;
-    /** Last modified timestamp (ms since epoch) */
-    mtimeMs: number;
-    /** File size in bytes */
-    sizeBytes: number;
-    /** Description extracted from first non-heading line */
-    description: string | null;
-    /** Category inferred from filename prefix */
-    category: string | null;
-}
 /** A selected relevant memory with content loaded. */
 export interface RelevantMemory {
     /** Filename */
@@ -46,23 +19,6 @@ export interface RelevantMemory {
     /** Whether content was truncated */
     truncated: boolean;
 }
-/**
- * Find memory files relevant to a user query.
- *
- * CC parity: scans topic files, scores by keyword + filename + recency,
- * selects top-N, loads content. No LLM needed (unlike CC's Sonnet call).
- *
- * @param query - User query text
- * @param memoryDir - Root of the MEMDIR directory (~/.qlogicagent/memory/)
- * @param alreadySurfaced - Paths already shown in prior turns (for dedup)
- * @returns Relevant memories with content, sorted by score
- */
-export declare function findRelevantMemories(query: string, memoryDir: string, alreadySurfaced?: ReadonlySet<string>): Promise<RelevantMemory[]>;
-/**
- * Scan memory directory for topic files (excludes INDEX.md).
- * Returns headers sorted by modification time (newest first).
- */
-export declare function scanMemoryHeaders(memoryDir: string): Promise<MemoryFileHeader[]>;
 /**
  * Format relevant memories as a single block for system prompt injection.
  * CC parity: includes freshness header per file.

package/dist/types/runtime/ports/memory-provider.d.ts

@@ -9,10 +9,15 @@ export interface MemorySearchOptions {
 }
 export interface MemorySearchResult {
     blockId: string;
-    id?: string;
+    /** [A8] REQUIRED — host guarantees id === blockId on every search hit. When id/content
+     * were optional, the {blockId,text} ↔ {id,path,content} drift silently type-checked:
+     * the LRU dedup key was always "" (dedup dead) and byte accounting always 0. */
+    id: string;
+    /** Historical field: L2 hits never carry a path (kept optional for legacy readers). */
     path?: string;
     text: string;
-    content?: string;
+    /** [A8] REQUIRED — host guarantees content === text on every search hit (see id). */
+    content: string;
     score: number;
     source?: string;
     metadata?: Record<string, unknown>;
@@ -47,6 +52,14 @@ export interface MemoryConsolidationWriteResult {
     conflictsAdded?: number;
     claimIds?: string[];
     conflictIds?: string[];
+    /** [A4] ingestExtracted 结构化回执:与入参同序、含被安全闸拒的项;created 带真实落库
+     * memoryId;merged(近重复合并)是合法成功不是失败。可重试失败不在带内(RPC 抛错即
+     * 调用方的重试通道)。可选:同一类型还约束 observe/propose 返回体,消费处按缺失兜底。 */
+    items?: Array<{
+        text: string;
+        outcome: "created" | "merged" | "conflicted" | "pending" | "rejected";
+        memoryId?: string;
+    }>;
 }
 export interface MemoryProvider {
     readonly providerId: string;

package/dist/types/skills/memory/host-memory-provider.d.ts

@@ -12,6 +12,8 @@
  *   search / addText / embedText / ingestExtracted / proposeExtracted / consumePendingProposals /
  *   feedback / findRelatedEvents / synthesizeTimeline / getActivitySummary / getAllProfiles /
  *   setProfile / getAtlas / setMemoryArchived / triggerDecay / resolveConflicts
+ *   [A9] 追加 listActiveMemoriesByTag(晋升扫描全量列举;无窗/无 clamp/无上限)。
+ *   [A10] 追加 promoteDistilledProcedure(升格窄 Saga;幂等/补偿/续跑在 Host)。
  *
  * 面外方法 = fail-loud throw(护栏抓漏):gate 开时 UI RPC 面(atlas 富查询/update/attachments/
  * proposals 消费等)由 gateway host-native 应答,**不该**再落到 qla 的 provider;到达此处 = 路由/
@@ -22,6 +24,7 @@
  * 纪律:fail-loud;单轨(创建时刻一次选型,非每调用分支);零 mock。
  */
 import type { HostRequestParams } from "../../host-contract/index.js";
+import type { CandidateStoreFile, ProcedureUsageStoreFile, PromotionStoreFile } from "./task-distillation.js";
 import type { MemoryActivitySummary, MemoryAtlasResult, MemoryConsolidationWriteResult, MemoryDreamRuntimeProvider, MemoryExtractionItem, MemoryHandlerProvider, MemoryIngestOptions, MemoryLearningSink, MemoryRuntimeHookProvider, MemorySearchOptions, MemorySearchResult, MemoryToolProvider } from "../../runtime/ports/index.js";
 /**
  * 最小转发口(结构化契约,由 coordinator-owned HostRequestClient 满足)。
@@ -107,6 +110,39 @@ export declare class HostMemoryProvider implements MemoryRuntimeHookProvider, Me
         conflictsResolved: number;
         claimsPromoted: number;
     }>;
+    readProcedureUsage(): Promise<ProcedureUsageStoreFile>;
+    writeProcedureUsage(store: ProcedureUsageStoreFile): Promise<void>;
+    readDistillCandidates(): Promise<CandidateStoreFile>;
+    writeDistillCandidates(store: CandidateStoreFile): Promise<void>;
+    readPromotionProposals(): Promise<PromotionStoreFile>;
+    writePromotionProposals(store: PromotionStoreFile): Promise<void>;
+    /** [A9] 晋升扫描全量列举:owner 活跃(未归档)记忆中标签含 tag 的行,无时间窗、
+     * 无页 clamp、无静默上限,created_at 升序(getAtlas 分页会让老配方掉出扫描)。 */
+    listActiveMemoriesByTag(userId: string, tag: string): Promise<Array<{
+        id: string;
+        text: string;
+        accessCount: number;
+        importance: number;
+    }>>;
+    /** [A10] 升格窄 Saga(Host 协调):create+verify → archive → proposal accepted 三步
+     * 横跨 Capability/Memory 两个 Host 存储,幂等(procedureId+确定性 skillName)、逐步
+     * 补偿、崩溃续跑全在 Host;大脑只做推理与提案后单调此法。 */
+    promoteDistilledProcedure(input: {
+        procedureId: string;
+        skillName: string;
+        content: string;
+        title: string;
+        accessCount: number;
+        auto: boolean;
+    }): Promise<{
+        outcome: "completed" | "already-completed";
+        skillName: string;
+        steps: {
+            skillCreated: boolean;
+            memoryArchived: boolean;
+            proposalAccepted: boolean;
+        };
+    }>;
     /** 本 provider 不持有 db 句柄/文件资源;close 为 no-op(shutdown 链 closeMemoryProviders 会调)。 */
     close(): void;
     remove(_memoryId: string): never;

package/dist/types/skills/memory/task-distillation.d.ts

@@ -8,11 +8,11 @@
  * 成功闸不用 LLM 自评:正常终态 + 同 session 近窗内未被"重做"(在线否决)。
  * 与 feedback-distillation(反馈域)无关 —— 这里蒸馏的是任务执行模式。
  *
- * 【B3 登记·刻意不动】本文件的 profile 级 JSON store 直写(task-distill-candidates.json /
- * promotion-proposals.json / procedure-usage.json,均 A 域)是 qla 写、gateway 读(gateway
- * MemoryProfileService 已持 promotion-proposals.json)的**文件级共享过渡态**——B3.1 只反转
- * memories.db 存取已收口为 HostMemoryProvider proxy,这批 JSON 随削藩批次归
- * store-owner(spec §1 X7 裁决第 4 条)。单一事实源 docs/agent-supervision-authority-migration-spec.md。
+ * 【X7 已完成】本文件是纯逻辑层,不做任何本地文件 IO。三份 profile JSON
+ * (task-distill-candidates / promotion-proposals / procedure-usage,均 A 域)的读写权威
+ * 已全部归 gateway MemoryProfileService(唯一写者);qlogicagent 大脑经 HostMemoryProvider
+ * proxy 的 read/write{DistillCandidates,PromotionProposals,ProcedureUsage} 存取,本文件只提供
+ * 采集/聚类/晋升的确定性算法。单一事实源 docs/agent-supervision-authority-migration-spec.md。
  */
 /** 同模式判定的余弦下限。错聚有害(把不同任务蒸成一份配方),漏聚无害(下次再攒)。 */
 export declare const TASK_DISTILL_CLUSTER_SIM = 0.86;
@@ -44,9 +44,9 @@ export interface TaskCandidate {
 export interface CandidateStoreFile {
     candidates: TaskCandidate[];
 }
-export declare function candidateStorePath(profileMemoryDir: string): string;
-export declare function readCandidateStore(path: string): CandidateStoreFile;
-export declare function writeCandidateStore(path: string, store: CandidateStoreFile): void;
+/** 滚动上限 + 过期清理(与技能模式同款 30 天窗口)。写入前就地裁剪 —— [X7] 代理写盘时
+ * 由大脑侧先裁再送 gateway store-owner(store-owner 只忠实持久化,不重述裁剪常量)。 */
+export declare function capCandidateStore(store: CandidateStoreFile, now?: number): void;
 export declare function cosine(a: readonly number[], b: readonly number[]): number;
 export interface CollectInput {
     id: string;
@@ -101,9 +101,6 @@ export interface PromotionProposal {
 export interface PromotionStoreFile {
     proposals: PromotionProposal[];
 }
-export declare function promotionStorePath(profileMemoryDir: string): string;
-export declare function readPromotionStore(path: string): PromotionStoreFile;
-export declare function writePromotionStore(path: string, store: PromotionStoreFile): void;
 /** 达标条目 upsert 为提议。dismissed/accepted 是终态,永不复活(拍板②:暂不=不再打扰)。
  * 已 proposed 的只刷新 accessCount。返回是否新增。 */
 export declare function upsertProposal(store: PromotionStoreFile, input: {
@@ -115,7 +112,9 @@ export declare function upsertProposal(store: PromotionStoreFile, input: {
 export declare function resolveProposal(store: PromotionStoreFile, procedureId: string, status: "accepted" | "dismissed", now: number): boolean;
 /** 降格:accepted → reverted(区分"暂不";降格率=reverted/accepted 家族)。 */
 export declare function revertProposal(store: PromotionStoreFile, procedureId: string, now: number): PromotionProposal | null;
-/** 配方文本 → SKILL.md 的确定性降级模板(LLM 格式转换失败时兜底)。 */
+/** 配方文本 → SKILL.md 的确定性降级模板(LLM 格式转换失败时兜底)。
+ * description 上限与写盘校验器同源(skill-validation MAX_DESCRIPTION_LENGTH):
+ * 曾经这里按 100 截,校验器按 60 打回,长标题配方在写盘前被自己仓拒绝。 */
 export declare function renderSkillMarkdownFallback(name: string, procedureText: string): string;
 /** 自动档解锁条件(拍板③):样本、接受率、降格率。 */
 export declare const V3_AUTO_MIN_SAMPLES = 10;
@@ -133,9 +132,6 @@ export interface ProcedureUsage {
 export interface ProcedureUsageStoreFile {
     usage: Record<string, ProcedureUsage>;
 }
-export declare function procedureUsagePath(profileMemoryDir: string): string;
-export declare function readProcedureUsage(path: string): ProcedureUsageStoreFile;
-export declare function writeProcedureUsage(path: string, store: ProcedureUsageStoreFile): void;
 export declare function recordProcedureRecall(store: ProcedureUsageStoreFile, procedureId: string, sessionId: string): void;
 export declare function recordProcedureNegative(store: ProcedureUsageStoreFile, procedureId: string): void;
 export interface PromotionMetrics {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.19.12",
+  "version": "2.19.13",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -146,7 +146,7 @@
     "@agentclientprotocol/sdk": "^0.25.0",
     "@napi-rs/canvas": "0.1.100",
     "@xiaozhiclaw/module-sdk": "0.2.1",
-    "@xiaozhiclaw/provider-core": "^0.1.27",
+    "@xiaozhiclaw/provider-core": "^0.1.28",
     "better-sqlite3": "^12.10.0",
     "dotenv": "^17.3.1",
     "ioredis": "^5.11.1",

package/dist/types/runtime/infra/codex-llmrouter-compat-proxy.d.ts

@@ -1,4 +0,0 @@
-export declare function filterCodexResponsesTools(body: unknown): unknown;
-export declare function ensureCodexLlmrouterCompatProxy(upstreamBaseUrl: string): Promise<string>;
-export declare function resetCodexLlmrouterCompatProxyForTests(): Promise<void>;
-export declare function setCodexLlmrouterCompatProxyDiagnosticPathForTests(path: string): void;