@carloswon/cairn-memory 0.0.0-stage → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +81 -0
- package/LICENSE +21 -0
- package/README.md +158 -2
- package/dist/src/agents/adapters.d.ts +82 -0
- package/dist/src/agents/adapters.js +209 -0
- package/dist/src/agents/adapters.js.map +1 -0
- package/dist/src/agents/config.d.ts +82 -0
- package/dist/src/agents/config.js +603 -0
- package/dist/src/agents/config.js.map +1 -0
- package/dist/src/agents/cordisPatch.d.ts +89 -0
- package/dist/src/agents/cordisPatch.js +201 -0
- package/dist/src/agents/cordisPatch.js.map +1 -0
- package/dist/src/agents/index.d.ts +2 -0
- package/dist/src/agents/index.js +3 -0
- package/dist/src/agents/index.js.map +1 -0
- package/dist/src/core/errors.d.ts +36 -0
- package/dist/src/core/errors.js +74 -0
- package/dist/src/core/errors.js.map +1 -0
- package/dist/src/core/hash.d.ts +14 -0
- package/dist/src/core/hash.js +48 -0
- package/dist/src/core/hash.js.map +1 -0
- package/dist/src/core/ids.d.ts +10 -0
- package/dist/src/core/ids.js +41 -0
- package/dist/src/core/ids.js.map +1 -0
- package/dist/src/core/index.d.ts +6 -0
- package/dist/src/core/index.js +7 -0
- package/dist/src/core/index.js.map +1 -0
- package/dist/src/core/scope.d.ts +78 -0
- package/dist/src/core/scope.js +181 -0
- package/dist/src/core/scope.js.map +1 -0
- package/dist/src/core/secrets.d.ts +13 -0
- package/dist/src/core/secrets.js +122 -0
- package/dist/src/core/secrets.js.map +1 -0
- package/dist/src/core/time.d.ts +7 -0
- package/dist/src/core/time.js +18 -0
- package/dist/src/core/time.js.map +1 -0
- package/dist/src/core/types.d.ts +139 -0
- package/dist/src/core/types.js +30 -0
- package/dist/src/core/types.js.map +1 -0
- package/dist/src/governance/apply.d.ts +64 -0
- package/dist/src/governance/apply.js +160 -0
- package/dist/src/governance/apply.js.map +1 -0
- package/dist/src/governance/archive.d.ts +29 -0
- package/dist/src/governance/archive.js +52 -0
- package/dist/src/governance/archive.js.map +1 -0
- package/dist/src/governance/dedup.d.ts +21 -0
- package/dist/src/governance/dedup.js +23 -0
- package/dist/src/governance/dedup.js.map +1 -0
- package/dist/src/governance/index.d.ts +16 -0
- package/dist/src/governance/index.js +17 -0
- package/dist/src/governance/index.js.map +1 -0
- package/dist/src/governance/propose.d.ts +78 -0
- package/dist/src/governance/propose.js +150 -0
- package/dist/src/governance/propose.js.map +1 -0
- package/dist/src/index.d.ts +15 -0
- package/dist/src/index.js +24 -0
- package/dist/src/index.js.map +1 -0
- package/dist/src/interfaces/app-service.d.ts +292 -0
- package/dist/src/interfaces/app-service.js +743 -0
- package/dist/src/interfaces/app-service.js.map +1 -0
- package/dist/src/interfaces/cli/main.d.ts +2 -0
- package/dist/src/interfaces/cli/main.js +854 -0
- package/dist/src/interfaces/cli/main.js.map +1 -0
- package/dist/src/interfaces/console/assets/page.d.ts +18 -0
- package/dist/src/interfaces/console/assets/page.js +39 -0
- package/dist/src/interfaces/console/assets/page.js.map +1 -0
- package/dist/src/interfaces/console/assets/ui-css.d.ts +11 -0
- package/dist/src/interfaces/console/assets/ui-css.js +119 -0
- package/dist/src/interfaces/console/assets/ui-css.js.map +1 -0
- package/dist/src/interfaces/console/assets/ui-js.d.ts +14 -0
- package/dist/src/interfaces/console/assets/ui-js.js +1098 -0
- package/dist/src/interfaces/console/assets/ui-js.js.map +1 -0
- package/dist/src/interfaces/console/assets/url-state.d.ts +9 -0
- package/dist/src/interfaces/console/assets/url-state.js +45 -0
- package/dist/src/interfaces/console/assets/url-state.js.map +1 -0
- package/dist/src/interfaces/console/export.d.ts +46 -0
- package/dist/src/interfaces/console/export.js +84 -0
- package/dist/src/interfaces/console/export.js.map +1 -0
- package/dist/src/interfaces/console/model.d.ts +372 -0
- package/dist/src/interfaces/console/model.js +731 -0
- package/dist/src/interfaces/console/model.js.map +1 -0
- package/dist/src/interfaces/console/review-store.d.ts +142 -0
- package/dist/src/interfaces/console/review-store.js +342 -0
- package/dist/src/interfaces/console/review-store.js.map +1 -0
- package/dist/src/interfaces/console/security.d.ts +76 -0
- package/dist/src/interfaces/console/security.js +105 -0
- package/dist/src/interfaces/console/security.js.map +1 -0
- package/dist/src/interfaces/console/server.d.ts +45 -0
- package/dist/src/interfaces/console/server.js +476 -0
- package/dist/src/interfaces/console/server.js.map +1 -0
- package/dist/src/interfaces/console/suggestions.d.ts +112 -0
- package/dist/src/interfaces/console/suggestions.js +511 -0
- package/dist/src/interfaces/console/suggestions.js.map +1 -0
- package/dist/src/interfaces/console/text.d.ts +4 -0
- package/dist/src/interfaces/console/text.js +18 -0
- package/dist/src/interfaces/console/text.js.map +1 -0
- package/dist/src/interfaces/mcp/server.d.ts +4 -0
- package/dist/src/interfaces/mcp/server.js +480 -0
- package/dist/src/interfaces/mcp/server.js.map +1 -0
- package/dist/src/jobs/index.d.ts +6 -0
- package/dist/src/jobs/index.js +7 -0
- package/dist/src/jobs/index.js.map +1 -0
- package/dist/src/jobs/remote.d.ts +42 -0
- package/dist/src/jobs/remote.js +34 -0
- package/dist/src/jobs/remote.js.map +1 -0
- package/dist/src/jobs/worker.d.ts +67 -0
- package/dist/src/jobs/worker.js +169 -0
- package/dist/src/jobs/worker.js.map +1 -0
- package/dist/src/onboarding/auto.d.ts +88 -0
- package/dist/src/onboarding/auto.js +399 -0
- package/dist/src/onboarding/auto.js.map +1 -0
- package/dist/src/onboarding/batches.d.ts +103 -0
- package/dist/src/onboarding/batches.js +219 -0
- package/dist/src/onboarding/batches.js.map +1 -0
- package/dist/src/onboarding/discover.d.ts +54 -0
- package/dist/src/onboarding/discover.js +369 -0
- package/dist/src/onboarding/discover.js.map +1 -0
- package/dist/src/onboarding/import.d.ts +69 -0
- package/dist/src/onboarding/import.js +279 -0
- package/dist/src/onboarding/import.js.map +1 -0
- package/dist/src/onboarding/index.d.ts +24 -0
- package/dist/src/onboarding/index.js +22 -0
- package/dist/src/onboarding/index.js.map +1 -0
- package/dist/src/onboarding/judgement.d.ts +50 -0
- package/dist/src/onboarding/judgement.js +121 -0
- package/dist/src/onboarding/judgement.js.map +1 -0
- package/dist/src/onboarding/policy.d.ts +86 -0
- package/dist/src/onboarding/policy.js +249 -0
- package/dist/src/onboarding/policy.js.map +1 -0
- package/dist/src/projection/brief.d.ts +112 -0
- package/dist/src/projection/brief.js +200 -0
- package/dist/src/projection/brief.js.map +1 -0
- package/dist/src/projection/index.d.ts +1 -0
- package/dist/src/projection/index.js +2 -0
- package/dist/src/projection/index.js.map +1 -0
- package/dist/src/projection/markdown.d.ts +82 -0
- package/dist/src/projection/markdown.js +313 -0
- package/dist/src/projection/markdown.js.map +1 -0
- package/dist/src/retrieval/export.d.ts +80 -0
- package/dist/src/retrieval/export.js +215 -0
- package/dist/src/retrieval/export.js.map +1 -0
- package/dist/src/retrieval/index.d.ts +5 -0
- package/dist/src/retrieval/index.js +6 -0
- package/dist/src/retrieval/index.js.map +1 -0
- package/dist/src/retrieval/search.d.ts +37 -0
- package/dist/src/retrieval/search.js +294 -0
- package/dist/src/retrieval/search.js.map +1 -0
- package/dist/src/store/archives.d.ts +94 -0
- package/dist/src/store/archives.js +135 -0
- package/dist/src/store/archives.js.map +1 -0
- package/dist/src/store/audit.d.ts +57 -0
- package/dist/src/store/audit.js +131 -0
- package/dist/src/store/audit.js.map +1 -0
- package/dist/src/store/backup.d.ts +36 -0
- package/dist/src/store/backup.js +90 -0
- package/dist/src/store/backup.js.map +1 -0
- package/dist/src/store/blocks.d.ts +64 -0
- package/dist/src/store/blocks.js +104 -0
- package/dist/src/store/blocks.js.map +1 -0
- package/dist/src/store/conflicts.d.ts +52 -0
- package/dist/src/store/conflicts.js +112 -0
- package/dist/src/store/conflicts.js.map +1 -0
- package/dist/src/store/db.d.ts +44 -0
- package/dist/src/store/db.js +162 -0
- package/dist/src/store/db.js.map +1 -0
- package/dist/src/store/device.d.ts +46 -0
- package/dist/src/store/device.js +111 -0
- package/dist/src/store/device.js.map +1 -0
- package/dist/src/store/index.d.ts +14 -0
- package/dist/src/store/index.js +15 -0
- package/dist/src/store/index.js.map +1 -0
- package/dist/src/store/memories.d.ts +133 -0
- package/dist/src/store/memories.js +442 -0
- package/dist/src/store/memories.js.map +1 -0
- package/dist/src/store/migrate.d.ts +32 -0
- package/dist/src/store/migrate.js +87 -0
- package/dist/src/store/migrate.js.map +1 -0
- package/dist/src/store/open.d.ts +53 -0
- package/dist/src/store/open.js +203 -0
- package/dist/src/store/open.js.map +1 -0
- package/dist/src/store/outbox.d.ts +65 -0
- package/dist/src/store/outbox.js +137 -0
- package/dist/src/store/outbox.js.map +1 -0
- package/dist/src/store/plans.d.ts +137 -0
- package/dist/src/store/plans.js +243 -0
- package/dist/src/store/plans.js.map +1 -0
- package/dist/src/store/schema.d.ts +46 -0
- package/dist/src/store/schema.js +544 -0
- package/dist/src/store/schema.js.map +1 -0
- package/dist/src/store/scopes.d.ts +44 -0
- package/dist/src/store/scopes.js +220 -0
- package/dist/src/store/scopes.js.map +1 -0
- package/dist/src/store/write-guard.d.ts +10 -0
- package/dist/src/store/write-guard.js +10 -0
- package/dist/src/store/write-guard.js.map +1 -0
- package/dist/src/sync/apply.d.ts +24 -0
- package/dist/src/sync/apply.js +130 -0
- package/dist/src/sync/apply.js.map +1 -0
- package/dist/src/sync/cryptoutil.d.ts +86 -0
- package/dist/src/sync/cryptoutil.js +339 -0
- package/dist/src/sync/cryptoutil.js.map +1 -0
- package/dist/src/sync/events.d.ts +69 -0
- package/dist/src/sync/events.js +78 -0
- package/dist/src/sync/events.js.map +1 -0
- package/dist/src/sync/obs-store.d.ts +41 -0
- package/dist/src/sync/obs-store.js +325 -0
- package/dist/src/sync/obs-store.js.map +1 -0
- package/dist/src/sync/orchestrate.d.ts +37 -0
- package/dist/src/sync/orchestrate.js +84 -0
- package/dist/src/sync/orchestrate.js.map +1 -0
- package/dist/src/sync/pull.d.ts +24 -0
- package/dist/src/sync/pull.js +150 -0
- package/dist/src/sync/pull.js.map +1 -0
- package/dist/src/sync/push.d.ts +19 -0
- package/dist/src/sync/push.js +227 -0
- package/dist/src/sync/push.js.map +1 -0
- package/dist/src/sync/syncd-store.d.ts +31 -0
- package/dist/src/sync/syncd-store.js +92 -0
- package/dist/src/sync/syncd-store.js.map +1 -0
- package/dist/src/sync/vault.d.ts +37 -0
- package/dist/src/sync/vault.js +53 -0
- package/dist/src/sync/vault.js.map +1 -0
- package/docs/cairn-security.md +267 -0
- package/docs/cairn-usage.md +919 -0
- package/package.json +71 -4
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 远端能力接口(design D9 / 构想 §11.1):本地 outbox 之上的可选上行边界。
|
|
3
|
+
* 本变更不实现真实云端——接口按 §11.1 签名冻结,MVP 恒返回 NotConfiguredRemote;
|
|
4
|
+
* delete 只供显式 purge 使用,因此不出现在常规同步接口里。
|
|
5
|
+
*/
|
|
6
|
+
/** 远端对象存储 + manifest 条件写的最小合同(后续变更接 ECS syncd / OBS)。 */
|
|
7
|
+
export interface RemoteStore {
|
|
8
|
+
getObject(key: string): Promise<Uint8Array | null>;
|
|
9
|
+
putImmutable(key: string, bytes: Uint8Array, hash: string): Promise<void>;
|
|
10
|
+
list(prefix: string, cursor?: string): Promise<{
|
|
11
|
+
keys: string[];
|
|
12
|
+
nextCursor?: string;
|
|
13
|
+
}>;
|
|
14
|
+
getManifest(space: string, device: string): Promise<unknown | null>;
|
|
15
|
+
putManifest(space: string, device: string, manifest: unknown, expectedGeneration: number): Promise<void>;
|
|
16
|
+
/** false = 一切上行调用都必须被拒绝(诚实降级,不假装同步成功)。 */
|
|
17
|
+
readonly configured: boolean;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* 未配置远端:configured=false,每个方法都以 E_FORBIDDEN/remote_not_configured 拒绝。
|
|
21
|
+
* 方法为 async:调用方一律以 Promise rejection 形式得到错误,不存在同步/异步两种抛出路径。
|
|
22
|
+
*/
|
|
23
|
+
export declare class NotConfiguredRemote implements RemoteStore {
|
|
24
|
+
readonly configured = false;
|
|
25
|
+
getObject(_key: string): Promise<Uint8Array | null>;
|
|
26
|
+
putImmutable(_key: string, _bytes: Uint8Array, _hash: string): Promise<void>;
|
|
27
|
+
list(_prefix: string, _cursor?: string): Promise<{
|
|
28
|
+
keys: string[];
|
|
29
|
+
nextCursor?: string;
|
|
30
|
+
}>;
|
|
31
|
+
getManifest(_space: string, _device: string): Promise<unknown | null>;
|
|
32
|
+
putManifest(_space: string, _device: string, _manifest: unknown, _expectedGeneration: number): Promise<void>;
|
|
33
|
+
}
|
|
34
|
+
/** 远端配置占位:真实云端接入属于后续变更(endpoint、credentialRef、vault 等届时定义)。 */
|
|
35
|
+
export interface RemoteStoreConfig {
|
|
36
|
+
[key: string]: unknown;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* 取得远端实现。MVP 恒返 NotConfiguredRemote:任何 config 都不会假装接入云端,
|
|
40
|
+
* doctor 如实报告 remote=not_configured(design Risks:不把 outbox 误解为已支持云同步)。
|
|
41
|
+
*/
|
|
42
|
+
export declare function getRemoteStore(_config?: RemoteStoreConfig): RemoteStore;
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { err } from '../core/errors.js';
|
|
2
|
+
function notConfiguredError() {
|
|
3
|
+
return err('E_FORBIDDEN', 'remote_not_configured');
|
|
4
|
+
}
|
|
5
|
+
/**
|
|
6
|
+
* 未配置远端:configured=false,每个方法都以 E_FORBIDDEN/remote_not_configured 拒绝。
|
|
7
|
+
* 方法为 async:调用方一律以 Promise rejection 形式得到错误,不存在同步/异步两种抛出路径。
|
|
8
|
+
*/
|
|
9
|
+
export class NotConfiguredRemote {
|
|
10
|
+
configured = false;
|
|
11
|
+
async getObject(_key) {
|
|
12
|
+
throw notConfiguredError();
|
|
13
|
+
}
|
|
14
|
+
async putImmutable(_key, _bytes, _hash) {
|
|
15
|
+
throw notConfiguredError();
|
|
16
|
+
}
|
|
17
|
+
async list(_prefix, _cursor) {
|
|
18
|
+
throw notConfiguredError();
|
|
19
|
+
}
|
|
20
|
+
async getManifest(_space, _device) {
|
|
21
|
+
throw notConfiguredError();
|
|
22
|
+
}
|
|
23
|
+
async putManifest(_space, _device, _manifest, _expectedGeneration) {
|
|
24
|
+
throw notConfiguredError();
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* 取得远端实现。MVP 恒返 NotConfiguredRemote:任何 config 都不会假装接入云端,
|
|
29
|
+
* doctor 如实报告 remote=not_configured(design Risks:不把 outbox 误解为已支持云同步)。
|
|
30
|
+
*/
|
|
31
|
+
export function getRemoteStore(_config) {
|
|
32
|
+
return new NotConfiguredRemote();
|
|
33
|
+
}
|
|
34
|
+
//# sourceMappingURL=remote.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"remote.js","sourceRoot":"","sources":["../../../src/jobs/remote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAmB,MAAM,mBAAmB,CAAC;AAmBzD,SAAS,kBAAkB;IACzB,OAAO,GAAG,CAAC,aAAa,EAAE,uBAAuB,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACrB,UAAU,GAAG,KAAK,CAAC;IAE5B,KAAK,CAAC,SAAS,CAAC,IAAY;QAC1B,MAAM,kBAAkB,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,MAAkB,EAAE,KAAa;QAChE,MAAM,kBAAkB,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,OAAgB;QAC1C,MAAM,kBAAkB,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,OAAe;QAC/C,MAAM,kBAAkB,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,OAAe,EAAE,SAAkB,EAAE,mBAA2B;QAChG,MAAM,kBAAkB,EAAE,CAAC;IAC7B,CAAC;CACF;AAOD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAA2B;IACxD,OAAO,IAAI,mBAAmB,EAAE,CAAC;AACnC,CAAC"}
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
import type { CairnStore } from '../store/open.js';
|
|
2
|
+
import type { JobRow, JobType } from '../store/outbox.js';
|
|
3
|
+
import { type RemoteStore } from './remote.js';
|
|
4
|
+
/**
|
|
5
|
+
* 后台 worker(design D9):outbox 任务的唯一消费者入口。
|
|
6
|
+
*
|
|
7
|
+
* 隔离合同(agent-interfaces spec「后台任务退出会话关键路径」):
|
|
8
|
+
* - handler 异常、超时、不可用能力一律转化为 outbox 的有界重试/dead 状态,绝不逃出 runOnce;
|
|
9
|
+
* - worker 只被显式调用(runOnce / runWorkerLoop),绝不自启,也不安装任何 hook;
|
|
10
|
+
* - runOnce 自身只在外部契约错误(claimReady/markDone/markFailedRetry 的存储层故障,如
|
|
11
|
+
* E_DB_LOCKED)时抛出——那是环境不可用,不是某个任务的失败。
|
|
12
|
+
*
|
|
13
|
+
* 安全边界:记录到 last_error 的文本经过 sanitize(截断 200 字符),
|
|
14
|
+
* worker 自己构造的错误绝不拼接 payload 或记忆正文。
|
|
15
|
+
*/
|
|
16
|
+
export declare const DEFAULT_JOB_TIMEOUT_MS = 30000;
|
|
17
|
+
/** maintain 把 running 任务判定为"属主 worker 已死"的阈值。 */
|
|
18
|
+
export declare const RUNNING_STALE_MS: number;
|
|
19
|
+
export interface JobContext {
|
|
20
|
+
store: CairnStore;
|
|
21
|
+
remote: RemoteStore;
|
|
22
|
+
/** 超时后由 worker 置 true 的协作式停止信号;handler 应周期性检查并尽快返回。 */
|
|
23
|
+
signal: {
|
|
24
|
+
get aborted(): boolean;
|
|
25
|
+
};
|
|
26
|
+
/** 本任务 wall-clock 截止时刻(Date.now() 基准)。 */
|
|
27
|
+
deadlineAt: number;
|
|
28
|
+
}
|
|
29
|
+
export type JobHandler = (job: JobRow, ctx: JobContext) => Promise<void> | void;
|
|
30
|
+
export interface RunOnceSummary {
|
|
31
|
+
processed: number;
|
|
32
|
+
done: number;
|
|
33
|
+
retry: number;
|
|
34
|
+
dead: number;
|
|
35
|
+
failures: {
|
|
36
|
+
id: string;
|
|
37
|
+
error: string;
|
|
38
|
+
}[];
|
|
39
|
+
}
|
|
40
|
+
export interface RunOnceOptions {
|
|
41
|
+
max?: number;
|
|
42
|
+
remote?: RemoteStore;
|
|
43
|
+
timeoutMs?: number;
|
|
44
|
+
now?: string;
|
|
45
|
+
}
|
|
46
|
+
export interface RunWorkerLoopOptions {
|
|
47
|
+
intervalMs: number;
|
|
48
|
+
maxCycles?: number;
|
|
49
|
+
remote?: RemoteStore;
|
|
50
|
+
timeoutMs?: number;
|
|
51
|
+
stop?: {
|
|
52
|
+
stopped: boolean;
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
export declare function registerHandler(type: JobType, handler: JobHandler): void;
|
|
56
|
+
/** 注册内置默认 handler(幂等;用于测试后恢复或 worker 入口初始化)。 */
|
|
57
|
+
export declare function registerDefaultHandlers(): void;
|
|
58
|
+
/**
|
|
59
|
+
* 领取并处理一批到期任务。handler 层的任何失败都留在 outbox 状态里;
|
|
60
|
+
* 只有外部契约错误(如 E_DB_LOCKED)才会抛出。
|
|
61
|
+
*/
|
|
62
|
+
export declare function runOnce(store: CairnStore, opts?: RunOnceOptions): Promise<RunOnceSummary>;
|
|
63
|
+
/**
|
|
64
|
+
* 轮询 worker:显式调用才运行,绝不自启。返回累计处理的任务数。
|
|
65
|
+
* stop.stopped 在每轮前后检查,供调用方从任意上下文请求停止。
|
|
66
|
+
*/
|
|
67
|
+
export declare function runWorkerLoop(store: CairnStore, opts: RunWorkerLoopOptions): Promise<number>;
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
import { err } from '../core/errors.js';
|
|
2
|
+
import { isoPlusMs, nowIso } from '../core/time.js';
|
|
3
|
+
import { getRemoteStore } from './remote.js';
|
|
4
|
+
/**
|
|
5
|
+
* 后台 worker(design D9):outbox 任务的唯一消费者入口。
|
|
6
|
+
*
|
|
7
|
+
* 隔离合同(agent-interfaces spec「后台任务退出会话关键路径」):
|
|
8
|
+
* - handler 异常、超时、不可用能力一律转化为 outbox 的有界重试/dead 状态,绝不逃出 runOnce;
|
|
9
|
+
* - worker 只被显式调用(runOnce / runWorkerLoop),绝不自启,也不安装任何 hook;
|
|
10
|
+
* - runOnce 自身只在外部契约错误(claimReady/markDone/markFailedRetry 的存储层故障,如
|
|
11
|
+
* E_DB_LOCKED)时抛出——那是环境不可用,不是某个任务的失败。
|
|
12
|
+
*
|
|
13
|
+
* 安全边界:记录到 last_error 的文本经过 sanitize(截断 200 字符),
|
|
14
|
+
* worker 自己构造的错误绝不拼接 payload 或记忆正文。
|
|
15
|
+
*/
|
|
16
|
+
export const DEFAULT_JOB_TIMEOUT_MS = 30_000;
|
|
17
|
+
/** maintain 把 running 任务判定为"属主 worker 已死"的阈值。 */
|
|
18
|
+
export const RUNNING_STALE_MS = 15 * 60 * 1000;
|
|
19
|
+
// ---------------------------------------------------------------------------
|
|
20
|
+
// handler 注册表:模块级,启动时为空——未注册类型诚实失败(no_handler_*),
|
|
21
|
+
// 而不是静默套用默认行为。默认 handler 通过 registerDefaultHandlers() 显式注册,
|
|
22
|
+
// 业务模块(如投影)可随时用 registerHandler 覆盖。
|
|
23
|
+
// ---------------------------------------------------------------------------
|
|
24
|
+
const registry = new Map();
|
|
25
|
+
export function registerHandler(type, handler) {
|
|
26
|
+
registry.set(type, handler);
|
|
27
|
+
}
|
|
28
|
+
/** 注册内置默认 handler(幂等;用于测试后恢复或 worker 入口初始化)。 */
|
|
29
|
+
export function registerDefaultHandlers() {
|
|
30
|
+
registry.set('maintain', defaultMaintainHandler);
|
|
31
|
+
registry.set('sync_upstream', defaultSyncUpstreamHandler);
|
|
32
|
+
registry.set('extract', modelRequiredHandler);
|
|
33
|
+
registry.set('embed', modelRequiredHandler);
|
|
34
|
+
registry.set('projection_rebuild', projectionNotRegisteredHandler);
|
|
35
|
+
}
|
|
36
|
+
// ---------------------------------------------------------------------------
|
|
37
|
+
// 默认 handler
|
|
38
|
+
// ---------------------------------------------------------------------------
|
|
39
|
+
/** maintain:过期计划清扫 + 崩溃遗留 running 复位(带 15 分钟新鲜度阈值,不误伤存活 worker)。 */
|
|
40
|
+
async function defaultMaintainHandler(_job, ctx) {
|
|
41
|
+
ctx.store.plans.expireStale();
|
|
42
|
+
const at = nowIso();
|
|
43
|
+
const cutoff = isoPlusMs(at, -RUNNING_STALE_MS);
|
|
44
|
+
// 语义化 resetRunningToPending:只复位 updated_at 早于阈值的 running 任务。
|
|
45
|
+
// 本轮 claimReady 刚领取的任务 updated_at 是新鲜的,不会被误伤。
|
|
46
|
+
ctx.store.db.run("UPDATE outbox_job SET status = 'pending', updated_at = ? WHERE status = 'running' AND updated_at <= ?", at, cutoff);
|
|
47
|
+
}
|
|
48
|
+
/** sync_upstream:未配置远端必须诚实失败;配置了远端也只做最小推送(MVP 无真实云端)。 */
|
|
49
|
+
async function defaultSyncUpstreamHandler(job, ctx) {
|
|
50
|
+
if (!ctx.remote.configured) {
|
|
51
|
+
throw err('E_FORBIDDEN', 'remote_not_configured');
|
|
52
|
+
}
|
|
53
|
+
// 最小实现:把任务载荷作为不可变对象推到 jobs/<job.id>.bin。
|
|
54
|
+
// chunk 级同步协议(manifest、代次、加密)属于后续变更。
|
|
55
|
+
const bytes = new TextEncoder().encode(JSON.stringify({
|
|
56
|
+
id: job.id,
|
|
57
|
+
entity_type: job.entityType,
|
|
58
|
+
entity_id: job.entityId,
|
|
59
|
+
payload_hash: job.payloadHash,
|
|
60
|
+
payload: job.payload,
|
|
61
|
+
}));
|
|
62
|
+
await ctx.remote.putImmutable(`jobs/${job.id}.bin`, bytes, job.payloadHash);
|
|
63
|
+
}
|
|
64
|
+
/** extract/embed:本变更无本地模型、无云端模型授权——诚实进入 retry/dead,不假装完成。 */
|
|
65
|
+
async function modelRequiredHandler(_job, _ctx) {
|
|
66
|
+
throw err('E_FORBIDDEN', 'extract_requires_model_config');
|
|
67
|
+
}
|
|
68
|
+
/** projection_rebuild:投影模块将来 registerHandler 覆盖本占位。 */
|
|
69
|
+
async function projectionNotRegisteredHandler(_job, _ctx) {
|
|
70
|
+
throw err('E_FORBIDDEN', 'projection_rebuild_handler_not_registered');
|
|
71
|
+
}
|
|
72
|
+
// ---------------------------------------------------------------------------
|
|
73
|
+
// 执行
|
|
74
|
+
// ---------------------------------------------------------------------------
|
|
75
|
+
/** sanitize:只取 message 并截断 200 字符;绝不拼接 payload/正文。 */
|
|
76
|
+
function sanitizeError(e) {
|
|
77
|
+
const raw = e instanceof Error ? e.message : String(e);
|
|
78
|
+
const s = raw.length > 200 ? raw.slice(0, 200) : raw;
|
|
79
|
+
return s.length > 0 ? s : 'empty_error';
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* 执行单个已领取任务。返回终态与已 sanitize 的错误文本。
|
|
83
|
+
* handler 的同步抛出、rejection、超时都被收敛为 markFailedRetry;
|
|
84
|
+
* 只有 outbox 存储层自身故障才会向上抛(外部契约错误)。
|
|
85
|
+
*/
|
|
86
|
+
async function executeJob(store, job, remote, timeoutMs) {
|
|
87
|
+
const abortFlag = { aborted: false };
|
|
88
|
+
const ctx = {
|
|
89
|
+
store,
|
|
90
|
+
remote,
|
|
91
|
+
signal: abortFlag,
|
|
92
|
+
deadlineAt: Date.now() + timeoutMs,
|
|
93
|
+
};
|
|
94
|
+
const handler = registry.get(job.jobType);
|
|
95
|
+
// 包一层 then:handler 的同步 throw 也变成 rejection,绝不直接逃出。
|
|
96
|
+
const work = Promise.resolve().then(() => {
|
|
97
|
+
if (!handler)
|
|
98
|
+
throw err('E_FORBIDDEN', `no_handler_for_${job.jobType}`);
|
|
99
|
+
return handler(job, ctx);
|
|
100
|
+
});
|
|
101
|
+
let timer;
|
|
102
|
+
const timeoutP = new Promise((_, reject) => {
|
|
103
|
+
timer = setTimeout(() => {
|
|
104
|
+
abortFlag.aborted = true; // 协作式停止信号;超时不能杀死仍在运行的 handler
|
|
105
|
+
reject(new Error('job_timeout'));
|
|
106
|
+
}, timeoutMs);
|
|
107
|
+
});
|
|
108
|
+
let failure;
|
|
109
|
+
try {
|
|
110
|
+
await Promise.race([work, timeoutP]);
|
|
111
|
+
}
|
|
112
|
+
catch (e) {
|
|
113
|
+
failure = e;
|
|
114
|
+
}
|
|
115
|
+
finally {
|
|
116
|
+
if (timer)
|
|
117
|
+
clearTimeout(timer);
|
|
118
|
+
}
|
|
119
|
+
if (failure === undefined) {
|
|
120
|
+
store.outbox.markDone(job.id);
|
|
121
|
+
return { outcome: 'done', error: '' };
|
|
122
|
+
}
|
|
123
|
+
const sanitized = sanitizeError(failure);
|
|
124
|
+
const row = store.outbox.markFailedRetry(job.id, sanitized);
|
|
125
|
+
return { outcome: row.status === 'dead' ? 'dead' : 'retry', error: sanitized };
|
|
126
|
+
}
|
|
127
|
+
/**
|
|
128
|
+
* 领取并处理一批到期任务。handler 层的任何失败都留在 outbox 状态里;
|
|
129
|
+
* 只有外部契约错误(如 E_DB_LOCKED)才会抛出。
|
|
130
|
+
*/
|
|
131
|
+
export async function runOnce(store, opts = {}) {
|
|
132
|
+
const max = opts.max ?? 10;
|
|
133
|
+
const now = opts.now ?? nowIso();
|
|
134
|
+
const remote = opts.remote ?? getRemoteStore();
|
|
135
|
+
const timeoutMs = Math.max(1, opts.timeoutMs ?? DEFAULT_JOB_TIMEOUT_MS);
|
|
136
|
+
const summary = { processed: 0, done: 0, retry: 0, dead: 0, failures: [] };
|
|
137
|
+
const jobs = store.outbox.claimReady(max, now);
|
|
138
|
+
for (const job of jobs) {
|
|
139
|
+
summary.processed += 1;
|
|
140
|
+
const { outcome, error } = await executeJob(store, job, remote, timeoutMs);
|
|
141
|
+
summary[outcome] += 1;
|
|
142
|
+
if (outcome !== 'done') {
|
|
143
|
+
summary.failures.push({ id: job.id, error });
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
return summary;
|
|
147
|
+
}
|
|
148
|
+
/**
|
|
149
|
+
* 轮询 worker:显式调用才运行,绝不自启。返回累计处理的任务数。
|
|
150
|
+
* stop.stopped 在每轮前后检查,供调用方从任意上下文请求停止。
|
|
151
|
+
*/
|
|
152
|
+
export async function runWorkerLoop(store, opts) {
|
|
153
|
+
const intervalMs = Math.max(0, opts.intervalMs);
|
|
154
|
+
const maxCycles = opts.maxCycles ?? Number.POSITIVE_INFINITY;
|
|
155
|
+
let total = 0;
|
|
156
|
+
for (let cycle = 0; cycle < maxCycles; cycle += 1) {
|
|
157
|
+
if (opts.stop?.stopped)
|
|
158
|
+
break;
|
|
159
|
+
const summary = await runOnce(store, { remote: opts.remote, timeoutMs: opts.timeoutMs });
|
|
160
|
+
total += summary.processed;
|
|
161
|
+
if (opts.stop?.stopped)
|
|
162
|
+
break;
|
|
163
|
+
if (cycle + 1 < maxCycles && intervalMs > 0) {
|
|
164
|
+
await new Promise((resolve) => setTimeout(resolve, intervalMs));
|
|
165
|
+
}
|
|
166
|
+
}
|
|
167
|
+
return total;
|
|
168
|
+
}
|
|
169
|
+
//# sourceMappingURL=worker.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../src/jobs/worker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAoB,MAAM,aAAa,CAAC;AAE/D;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAC7C,iDAAiD;AACjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAoC/C,8EAA8E;AAC9E,kDAAkD;AAClD,4DAA4D;AAC5D,oCAAoC;AACpC,8EAA8E;AAE9E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;AAEhD,MAAM,UAAU,eAAe,CAAC,IAAa,EAAE,OAAmB;IAChE,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,uBAAuB;IACrC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;IACjD,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,0BAA0B,CAAC,CAAC;IAC1D,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;IAC9C,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;IAC5C,QAAQ,CAAC,GAAG,CAAC,oBAAoB,EAAE,8BAA8B,CAAC,CAAC;AACrE,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,oEAAoE;AACpE,KAAK,UAAU,sBAAsB,CAAC,IAAY,EAAE,GAAe;IACjE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IAC9B,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC;IAChD,6DAA6D;IAC7D,8CAA8C;IAC9C,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CACd,uGAAuG,EACvG,EAAE,EACF,MAAM,CACP,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,KAAK,UAAU,0BAA0B,CAAC,GAAW,EAAE,GAAe;IACpE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC3B,MAAM,GAAG,CAAC,aAAa,EAAE,uBAAuB,CAAC,CAAC;IACpD,CAAC;IACD,yCAAyC;IACzC,qCAAqC;IACrC,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CACpC,IAAI,CAAC,SAAS,CAAC;QACb,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,WAAW,EAAE,GAAG,CAAC,UAAU;QAC3B,SAAS,EAAE,GAAG,CAAC,QAAQ;QACvB,YAAY,EAAE,GAAG,CAAC,WAAW;QAC7B,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC,CACH,CAAC;IACF,MAAM,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;AAC9E,CAAC;AAED,6DAA6D;AAC7D,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,IAAgB;IAChE,MAAM,GAAG,CAAC,aAAa,EAAE,+BAA+B,CAAC,CAAC;AAC5D,CAAC;AAED,uDAAuD;AACvD,KAAK,UAAU,8BAA8B,CAAC,IAAY,EAAE,IAAgB;IAC1E,MAAM,GAAG,CAAC,aAAa,EAAE,2CAA2C,CAAC,CAAC;AACxE,CAAC;AAED,8EAA8E;AAC9E,KAAK;AACL,8EAA8E;AAE9E,sDAAsD;AACtD,SAAS,aAAa,CAAC,CAAU;IAC/B,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;AAC1C,CAAC;AAID;;;;GAIG;AACH,KAAK,UAAU,UAAU,CACvB,KAAiB,EACjB,GAAW,EACX,MAAmB,EACnB,SAAiB;IAEjB,MAAM,SAAS,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACrC,MAAM,GAAG,GAAe;QACtB,KAAK;QACL,MAAM;QACN,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;KACnC,CAAC;IACF,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1C,mDAAmD;IACnD,MAAM,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QACtD,IAAI,CAAC,OAAO;YAAE,MAAM,GAAG,CAAC,aAAa,EAAE,kBAAkB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACxE,OAAO,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IACH,IAAI,KAAiC,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAChD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,8BAA8B;YACxD,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACnC,CAAC,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,GAAG,CAAC,CAAC;IACd,CAAC;YAAS,CAAC;QACT,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACxC,CAAC;IACD,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAC5D,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACjF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAiB,EAAE,OAAuB,EAAE;IACxE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,MAAM,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,IAAI,sBAAsB,CAAC,CAAC;IACxE,MAAM,OAAO,GAAmB,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC3F,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;QACvB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC3E,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAiB,EAAE,IAA0B;IAC/E,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,iBAAiB,CAAC;IAC7D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,IAAI,CAAC,IAAI,EAAE,OAAO;YAAE,MAAM;QAC9B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACzF,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC;QAC3B,IAAI,IAAI,CAAC,IAAI,EAAE,OAAO;YAAE,MAAM;QAC9B,IAAI,KAAK,GAAG,CAAC,GAAG,SAAS,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import type { CairnStore } from '../store/index.js';
|
|
2
|
+
import { type SuggestedAction } from '../interfaces/console/suggestions.js';
|
|
3
|
+
import { type PolicyCondition } from './policy.js';
|
|
4
|
+
/**
|
|
5
|
+
* 自动编排(design D1 / D2 / D6 / D7)。
|
|
6
|
+
*
|
|
7
|
+
* 这个模块只做三件事:把条目分成 auto / manual 两档、按作用域生成计划、
|
|
8
|
+
* 用已签发策略代签审批并应用。它**不判断内容好不好**——那是规则层与 AI 层的事,
|
|
9
|
+
* 它只回答"已签发的策略允许不允许自动处理这一条"。
|
|
10
|
+
*
|
|
11
|
+
* 不 import AppService:AppService 会反过来 import 本模块,互相引用会让
|
|
12
|
+
* 初始化顺序变得不可预测。这里直接用 store 与 governance 层的原语。
|
|
13
|
+
*/
|
|
14
|
+
export interface AutoRunScopeSelection {
|
|
15
|
+
preset?: string;
|
|
16
|
+
projectId?: string;
|
|
17
|
+
scopeId?: string;
|
|
18
|
+
}
|
|
19
|
+
export interface AutoRunInput {
|
|
20
|
+
policyId: string;
|
|
21
|
+
batchId?: string;
|
|
22
|
+
scope?: AutoRunScopeSelection;
|
|
23
|
+
/** 只分档不写库。 */
|
|
24
|
+
dryRun?: boolean;
|
|
25
|
+
/** 只处理这些条目;省略表示整批。 */
|
|
26
|
+
itemIds?: string[];
|
|
27
|
+
/**
|
|
28
|
+
* 重新处理已晋升过的条目。默认跳过:同一批跑第二次不该把记忆再走一遍 merge。
|
|
29
|
+
* 撤销之后要重做,用这个开关显式声明意图。
|
|
30
|
+
*/
|
|
31
|
+
redo?: boolean;
|
|
32
|
+
/** 审批有效期,默认 5 分钟。 */
|
|
33
|
+
ttlMs?: number;
|
|
34
|
+
}
|
|
35
|
+
export interface AutoTierEntry {
|
|
36
|
+
itemId: string;
|
|
37
|
+
tier: 'auto' | 'manual';
|
|
38
|
+
action: SuggestedAction;
|
|
39
|
+
reason: string;
|
|
40
|
+
failedCondition: PolicyCondition | null;
|
|
41
|
+
detail: string;
|
|
42
|
+
}
|
|
43
|
+
export interface AutoPlanResult {
|
|
44
|
+
planId: string;
|
|
45
|
+
scopeId: string;
|
|
46
|
+
ops: number;
|
|
47
|
+
applied: number;
|
|
48
|
+
skipped: number;
|
|
49
|
+
failed: number;
|
|
50
|
+
approvalId: string;
|
|
51
|
+
}
|
|
52
|
+
export interface AutoRunSummary {
|
|
53
|
+
policyId: string;
|
|
54
|
+
policyHashPrefix: string;
|
|
55
|
+
batchId: string;
|
|
56
|
+
scopeId: string;
|
|
57
|
+
scopeName: string;
|
|
58
|
+
dryRun: boolean;
|
|
59
|
+
totalItems: number;
|
|
60
|
+
auto: number;
|
|
61
|
+
manual: number;
|
|
62
|
+
applied: number;
|
|
63
|
+
skipped: number;
|
|
64
|
+
failed: number;
|
|
65
|
+
/** 转人工的条目按未满足条件计数。 */
|
|
66
|
+
byCondition: Record<string, number>;
|
|
67
|
+
byAction: Record<string, number>;
|
|
68
|
+
failures: {
|
|
69
|
+
itemId: string;
|
|
70
|
+
code: string;
|
|
71
|
+
message: string;
|
|
72
|
+
}[];
|
|
73
|
+
plans: AutoPlanResult[];
|
|
74
|
+
/** 汇总自校验:applied + skipped + failed + manual === totalItems。 */
|
|
75
|
+
balanced: boolean;
|
|
76
|
+
tiers: AutoTierEntry[];
|
|
77
|
+
}
|
|
78
|
+
export declare function runAutoOnboarding(store: CairnStore, input: AutoRunInput): AutoRunSummary;
|
|
79
|
+
/**
|
|
80
|
+
* 按策略撤销(design D7):转 tombstone 而不物理删除,并且让同一批次可以被重新整理
|
|
81
|
+
* ——判定不认 tombstoned,所以重新整理不会撞上自己留下的墓碑。
|
|
82
|
+
*/
|
|
83
|
+
export declare function revokeByPolicy(store: CairnStore, policyId: string, opts?: {
|
|
84
|
+
batchId?: string;
|
|
85
|
+
}): {
|
|
86
|
+
tombstoned: number;
|
|
87
|
+
memoryIds: string[];
|
|
88
|
+
};
|