M3(完成): interaction 与 activity-registry

interaction(L3): - 控制权按态转交:活动在跑归活动,流转/审批/终态归系统;输入侧永远归系统(单入口) - 视图区净化门:含 <script> / on* / 外部资源的模版一律拒推 —— 容器无脚本执行权 - 对话流单入口:自由输入同写任务记忆并抛人事件;SSE 单连接 + 按目标失效广播 - 前端零过程状态:对话流与视图都是服务端投影 activity-registry(L4): - 安装两审:静态审(签名/SDK/工具契约齐备/模型名已绑定/schema/悬空监听/模版无脚本/ 零环境能力/动态执行/验收等级不得谎报)+ 回放审(旧成不坏是硬门,旧败能成只入报告) - 资产与包分离版本化:包只携资产初始版,不覆盖已有更高资产版;装载 = 包版本 + 生效资产版 - 进化管线状态机:候选 → 回放 → 人放行 → 生效;回退是显式治理动作 245 个测试通过,门禁五道全绿 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
2026-07-27 01:36:05 +08:00
parent d96c6e6dff
commit 2850e6d4ef
29 changed files with 4339 additions and 4 deletions
@@ -0,0 +1,69 @@
+/**
+ * module: activity-registry —— 对外类型(编码规范 §10.1;语义出处 OS 11,AM 11)。
+ *
+ * 活动库:**独立的安装与卸载入口** —— 不在编排中发生。
+ * 安装恒为新增、版本并存;在途任务按其启动时版本跑完,切换零丢单。
+ */
+import type { ActivityManifest, InstallVerdict, Paradigm, StaticAuditFinding } from '@contracts';
+import type { AssetKind, AssetVersion, IncrementState, LoadEnvelope, PackageVersion, ReplayCase, ReplayVerdict } from './internal/domain/versioning.ts';
+import type { ExternalChecks } from './internal/domain/static-audit.ts';
+export type { ActivityManifest, AssetKind, AssetVersion, ExternalChecks, IncrementState, InstallVerdict, LoadEnvelope, PackageVersion, Paradigm, ReplayCase, ReplayVerdict, StaticAuditFinding, };
+export declare class InstallRejectedError extends Error {
+    readonly verdict: InstallVerdict;
+    constructor(verdict: InstallVerdict);
+}
+export declare class ActivityNotInstalledError extends Error {
+    readonly activityId: string;
+    constructor(activityId: string);
+}
+export declare class ToolNotDeclaredError extends Error {
+    readonly missing: readonly string[];
+    constructor(missing: readonly string[]);
+}
+/** 库内两维管理:业务分类(一级,组织自定)× 活动类型(标准 / 案例)—— 两维平级、相互独立 */
+export type ActivityCard = {
+    readonly activityId: string;
+    readonly name: string;
+    readonly category: string;
+    readonly paradigm: Paradigm;
+    readonly packageVersions: readonly PackageVersion[];
+    readonly assetVersions: readonly AssetVersion[];
+    readonly enabled: boolean;
+};
+/** 编排导出的依赖文件 —— 清单骨架:契约区 + 声明区(OS 11.1 第 2 步) */
+export type DependencyFile = {
+    readonly activityId: string;
+    readonly contract: ActivityManifest['contract'];
+    readonly declarations: ActivityManifest['declarations'];
+    readonly compileOptions: {
+        readonly sdkVersion: string;
+        readonly format: 'esm';
+        readonly single: true;
+    };
+};
+export type ActivityRegistryService = {
+    /** 安装两审:静态审读清单,回放审重演历史 */
+    install(manifest: ActivityManifest, artifact: string): Promise<InstallVerdict>;
+    list(): Promise<ActivityCard[]>;
+    get(activityId: string): Promise<ActivityCard | undefined>;
+    setEnabled(activityId: string, enabled: boolean): Promise<void>;
+    uninstall(activityId: string): Promise<void>;
+    /** 任务装载 = 包版本 + 各资产当前生效版,全部入信封 */
+    loadEnvelope(activityId: string): Promise<LoadEnvelope>;
+    manifestOf(activityId: string, packageVersion?: string): Promise<ActivityManifest>;
+    /** 进化管线:候选 → 回放 → 人放行 → 生效;可回退 */
+    proposeIncrement(input: {
+        activityId: string;
+        kind: AssetKind;
+        diff: string;
+        evidenceEntryIds: readonly string[];
+    }): Promise<{
+        incrementId: string;
+        state: IncrementState;
+    }>;
+    replayIncrement(incrementId: string, cases: readonly ReplayCase[]): Promise<ReplayVerdict>;
+    releaseIncrement(incrementId: string, by: string): Promise<AssetVersion>;
+    rejectIncrement(incrementId: string, reason: string): Promise<void>;
+    /** 行为回退 = 版本回退(显式治理动作) */
+    rollbackAsset(activityId: string, kind: AssetKind, toVersion: number): Promise<AssetVersion>;
+};