@fa-software/semi2-dsh 0.0.13 → 0.0.14-preview.20260922051239

package/lib/index.js

@@ -58,14 +58,6 @@ export function apply(ctx, config) {
     ctx.provide('semi2Health', configuration.health);
     // 运行面（NPC 面）回报生命周期与交付事实的出口；上报失败只 warn。
     ctx.provide('semi2Audit', configuration.audit);
-    // 优雅卸载 = 本面会话结束：进程被强杀（SIGKILL / 容器停止）没有结束行，属已知边界。
-    ctx.effect(() => () => {
-        void configuration.audit.report({
-            action: 'SESSION_END',
-            outcome: 'SUCCESS',
-            detail: { platform: configuration.config.platform, reason: 'dispose' },
-        });
-    });
     // 索引由使用方建立、工具由官方 MCP 服务提供：插件侧没有可失败的后台动作，只标注开关状态。
     configuration.registerHealth({
         key: 'healthCodegraph',

package/lib/service/audit.js

@@ -1,19 +1,33 @@
-/** 生命周期事件：动作名与结果名都用 hub SDL 的枚举名，两侧不各维护一张映射表。 */
-export async function reportEvent(engine, event) {
+/**
+ * 上报一条运行面事件并回结果：本面标识（`face`）与运行面契约里的任务引用在这里补齐，
+ * 调用方（会话订阅 / 适配器）不必各自知道这两个事实从哪来。
+ */
+export async function reportEventResult(engine, event) {
+    if (engine.connection() === null)
+        return { ok: false, code: 'MISSING_ACCESS_TOKEN' };
+    // 任务引用来自运行面契约（NPC 适配器解析触发后填），本插件不自己解析触发事实。
+    const taskRef = engine.contract()?.taskRef;
     try {
-        if (engine.connection() === null)
-            return;
         const outcome = await engine.api.reportEvent({
             ...event,
+            ...(taskRef === undefined || taskRef === '' ? {} : { runRef: taskRef }),
             detail: { face: faceOf(engine), ...(event.detail ?? {}) },
         });
-        if (outcome.data === null)
-            engine.warn(`运行面事件上报失败（${event.action}）：${outcome.errorCode ?? '未知错误'}`);
+        return { ok: outcome.data !== null, code: outcome.errorCode };
     }
     catch (error) {
-        engine.warn(`运行面事件上报失败（${event.action}）：${error instanceof Error ? error.message : String(error)}`);
+        return {
+            ok: false,
+            code: error instanceof Error ? error.message : String(error),
+        };
     }
 }
+/** 生命周期事件：动作名与结果名都用 hub SDL 的枚举名，两侧不各维护一张映射表。 */
+export async function reportEvent(engine, event) {
+    const result = await reportEventResult(engine, event);
+    if (!result.ok)
+        engine.warn(`运行面事件上报失败（${event.action}）：${result.code ?? '未知错误'}`);
+}
 /** 本面标识：契约里有就用它；宿主直跑没有契约，记 host。 */
 export function faceOf(engine) {
     const declared = engine.contract()?.face;

package/lib/service/config-service.js

@@ -1,7 +1,8 @@
 import { createSemi2Api } from '../api/index.js';
 import { createPorts } from './ports.js';
 import { Orchestrator } from './orchestrator.js';
-import { faceOf } from './audit.js';
+import { reportEventResult } from './audit.js';
+import { installSessionReporting } from './sessions.js';
 import * as lifecycle from './lifecycle.js';
 /**
  * 装配三个能力面并开始后台领取：领域挂载与首次取数都在后台——不阻塞插件树 settle，
@@ -23,9 +24,13 @@ export function installConfiguration(ctx, options = {}) {
         createSemi2Api({
             readConnection: () => engineRef.current?.connection() ?? null,
             environment: { ...process.env },
-            readFace: () => engineRef.current?.contract()?.face,
+            // 契约缺席即宿主直跑：本面标识回落 `host`，别让会话落成「未标注」。
+            readFace: () => engineRef.current?.contract()?.face ??
+                (engineRef.current?.platform === 'host' ? 'host' : undefined),
         }), ports, { ...process.env }, options);
     engineRef.current = orchestrator;
+    // 客户端会话日志的事实来源：旁听 dsh 的会话创建 / 销毁（服务缺席时自动跳过）。
+    installSessionReporting(orchestrator);
     void orchestrator
         .mountDomains()
         .then(() => lifecycle.start(orchestrator))
@@ -40,26 +45,7 @@ export function installConfiguration(ctx, options = {}) {
         },
         health: { snapshot: () => orchestrator.healthSnapshot() },
         audit: {
-            report: async (event) => {
-                if (orchestrator.connection() === null)
-                    return { ok: false, code: 'MISSING_ACCESS_TOKEN' };
-                try {
-                    const outcome = await orchestrator.api.reportEvent({
-                        ...event,
-                        detail: {
-                            face: faceOf(orchestrator),
-                            ...(event.detail ?? {}),
-                        },
-                    });
-                    return { ok: outcome.data !== null, code: outcome.errorCode };
-                }
-                catch (error) {
-                    return {
-                        ok: false,
-                        code: error instanceof Error ? error.message : String(error),
-                    };
-                }
-            },
+            report: event => reportEventResult(orchestrator, event),
         },
         registerHealth: (contributor) => {
             orchestrator.registerHealthContributor(contributor);

package/lib/service/lifecycle.js

@@ -5,7 +5,6 @@ import { installSections } from './settings-sections.js';
 import { appliedState, publishFailed, publishStatus } from './publish.js';
 import { readOwned, readWorkspaces } from './namespaces.js';
 import { DOMAINS } from './registry.js';
-import { reportEvent } from './audit.js';
 import { connectionSnapshot, exchangeCnbCredential, resolveConnectionWithRetry, resolveContract, } from './connection.js';
 /** 首次加载；未配凭据或失败只落到 state.error，绝不 throw，也不注入任何配置。 */
 export async function start(engine) {
@@ -39,20 +38,6 @@ export async function start(engine) {
         else
             await load(engine);
         await publishStatus(engine);
-        // 会话启动 = 首次配置领取成功；未配凭据 / 领取失败都不是「会话起来过」。
-        // NPC 面自己的会话起点由适配器上报（带触发事实），这里只覆盖另外两个 Web 面与宿主直跑。
-        if (engine.connection() !== null &&
-            engine.state().status === 'ready' &&
-            engine.contract()?.face !== 'npc')
-            await reportEvent(engine, {
-                action: 'SESSION_START',
-                outcome: 'SUCCESS',
-                detail: {
-                    platform: engine.platform,
-                    consoleUrl: engine.connection()?.url ?? null,
-                    identity: engine.state().identity?.username ?? null,
-                },
-            });
     }
     finally {
         engine.settle();

package/lib/service/registry.js

@@ -1,5 +1,6 @@
 import { defaultModelDomain } from '../domains/default-model/index.js';
 import { modelsDomain } from '../domains/models/index.js';
+import { redmineDomain } from '../domains/redmine/index.js';
 import { secretsDomain } from '../domains/secrets/index.js';
 import { selfPortraitDomain } from '../domains/self-portrait/index.js';
 import { skillsDomain } from '../domains/skills/index.js';
@@ -12,4 +13,5 @@ export const DOMAINS = [
     workspaceDomain,
     defaultModelDomain,
     selfPortraitDomain,
+    redmineDomain,
 ];

package/lib/service/sessions.js

@@ -0,0 +1,90 @@
+// @fa-software/semi2-dsh/service/sessions —— dsh 会话生命周期上报：一次会话一行。
+// 只报顶层会话（子 agent 的会话跳过）；dsh-session 服务缺席或上报失败都只 warn 降级，
+// 会话照跑——hub 的客户端会话日志是旁路事实，不是会话的前提。
+import { randomUUID } from 'node:crypto';
+import { canonicalPath } from '../hub/workspace-book.js';
+import { reportEvent } from './audit.js';
+/**
+ * 本面实例标识：同名 dsh 会话（`session-1`）在不同容器里会撞车，hub 靠它分开。
+ * 每次进程启动生成一个，进程内所有会话共用。
+ */
+const CLIENT_ID = randomUUID();
+/** 子 agent 的会话不是「用户开的会话」：不建行、不计数。 */
+function isUserSession(session) {
+    return session.header.origin !== 'subagent';
+}
+/**
+ * 会话归属：cwd 命中的已登记工作区给 slug，项目由工作区领域按 cwd 解析。
+ * 拿不到就是拿不到（不落占位值）——headless 面没有工作区服务时也走这条。
+ */
+async function scopeOf(engine, cwd) {
+    const directory = cwd?.trim() ?? '';
+    if (directory === '')
+        return { workspacePath: null, workspaceSlug: null, projectSlug: null };
+    const canonical = await canonicalPath(directory);
+    const entry = engine
+        .workspace()
+        .tracked()
+        .find(item => item.path === canonical);
+    const project = await engine.peer('workspace')?.projectForCwd(canonical);
+    return {
+        workspacePath: canonical,
+        workspaceSlug: entry?.slug ?? null,
+        projectSlug: project?.slug ?? null,
+    };
+}
+/** 会话创建：带上工作区与默认模型选择，hub 据此建行。 */
+async function reportCreated(engine, session) {
+    const scope = await scopeOf(engine, session.header.cwd);
+    const selection = engine.ctx.get('agentDefaultModel', false)?.currentSelection?.();
+    await reportEvent(engine, {
+        action: 'SESSION_CREATED',
+        outcome: 'SUCCESS',
+        code: 'created',
+        sessionId: session.id,
+        clientId: CLIENT_ID,
+        ...(scope.workspacePath === null ? {} : { workspacePath: scope.workspacePath }),
+        ...(scope.workspaceSlug === null ? {} : { workspaceSlug: scope.workspaceSlug }),
+        ...(scope.projectSlug === null ? {} : { projectSlug: scope.projectSlug }),
+        ...(selection?.model === undefined || selection.model === ''
+            ? {}
+            : { modelId: selection.model }),
+        ...(selection?.reasoningEffort === undefined ||
+            selection.reasoningEffort === ''
+            ? {}
+            : { reasoningLevel: selection.reasoningEffort }),
+        detail: { cwd: scope.workspacePath },
+    });
+}
+/** 会话销毁：回填结束时间与原因码；进程被强杀时没有这一条（页面显示「无结束行」）。 */
+async function reportDisposed(engine, session) {
+    await reportEvent(engine, {
+        action: 'SESSION_DISPOSED',
+        outcome: 'SUCCESS',
+        code: 'dispose',
+        sessionId: session.id,
+        clientId: CLIENT_ID,
+    });
+}
+/**
+ * 挂上会话订阅：dsh 的会话是事件源的（`session/created` / `session/disposed`），
+ * 本插件只旁听，不改会话行为。`sessions` 服务缺席时整块跳过。
+ * 返回订阅光纤（可 await 到就绪），测试据它确认监听已挂上。
+ */
+export function installSessionReporting(engine, ctx = engine.ctx) {
+    return ctx.inject(['sessions'], (scoped) => {
+        const track = (session, report) => {
+            if (!isUserSession(session))
+                return;
+            void report(engine, session).catch((error) => {
+                engine.warn(`会话上报失败：${error instanceof Error ? error.message : String(error)}`);
+            });
+        };
+        scoped.on('session/created', (session) => {
+            track(session, reportCreated);
+        });
+        scoped.on('session/disposed', (session) => {
+            track(session, reportDisposed);
+        });
+    });
+}

package/lib/types/api/generated/documents.d.ts

@@ -1,5 +1,5 @@
 /** 启动装配：五个用户级领域一个文档（项目绑定按工作区另行按需取）。 */
-export declare const RUNTIME_BOOT_DOCUMENT = "query RuntimeBoot {\n  runtimeViewer {\n    id\n    username\n    displayName\n  }\n  runtimeModels {\n    id\n    upstreamId\n    displayName\n    metadata { contextWindow maxTokens input reasoningLevels }\n    defaultReasoningLevel\n    connection { id provider protocol baseUrl }\n  }\n  runtimeDefaultModelId\n  runtimeHeadlessModels {\n    planModelId\n    executeModelId\n  }\n  runtimeModelCredentials {\n    connectionId\n    value\n  }\n  runtimeSkills {\n    id\n    projectId\n    name\n    description\n    whenToUse\n    content\n    version\n    files {\n      path\n      sizeBytes\n      mimeType\n      isExecutable\n    }\n    fileCount\n    filesBytes\n  }\n  runtimeSelfPortrait\n}";
+export declare const RUNTIME_BOOT_DOCUMENT = "query RuntimeBoot {\n  runtimeViewer {\n    id\n    username\n    displayName\n  }\n  runtimeModels {\n    id\n    upstreamId\n    displayName\n    metadata { contextWindow maxTokens input reasoningLevels }\n    defaultReasoningLevel\n    connection { id provider protocol baseUrl }\n  }\n  runtimeDefaultModelId\n  runtimeHeadlessModels {\n    planModelId\n    executeModelId\n  }\n  runtimeModelCredentials {\n    connectionId\n    value\n  }\n  runtimeSkills {\n    id\n    projectId\n    name\n    description\n    whenToUse\n    content\n    version\n    files {\n      path\n      sizeBytes\n      mimeType\n      isExecutable\n    }\n    fileCount\n    filesBytes\n  }\n  runtimeSelfPortrait\n  runtimeRedmine {\n    baseUrl\n    apiKey\n  }\n}";
 /** 技能附属资源字节：boot 文档只带清单，真正加载某个技能时才按需取这一条。可空根字段：读取者不可见 / 不存在回空数组（权威「没有」），领域失败回 null（降级，不物化）。 */
 export declare const RUNTIME_SKILL_FILES_DOCUMENT = "query RuntimeSkillFiles($skillId: ID!) {\n  runtimeSkillFiles(skillId: $skillId) {\n    path\n    content\n    encoding\n    sizeBytes\n    mimeType\n    isExecutable\n  }\n}";
 /** 项目绑定按 slug 取：只问已登记工作区命中的那几个项目，绝不把整张项目表拉回本地。`slugs` 是读范围之上的过滤（不是绕过），空数组 = 空集合。 */

package/lib/types/api/generated/graphql.d.ts

@@ -14,21 +14,34 @@ export type InputModality = 'IMAGE' | 'TEXT';
 export type ModelProtocol = 'ANTHROPIC' | 'DEEPSEEK' | 'OPENAI_CHAT' | 'OPENAI_RESPONSES';
 export type ReasoningLevel = 'HIGH' | 'LOW' | 'MAX' | 'MEDIUM' | 'MINIMAL' | 'OFF' | 'XHIGH';
 /** 运行面可上报的动作：会话启停、拒绝、交付分支与交付核对。 */
-export type RuntimeEventAction = 'DELIVERY_READY' | 'DELIVERY_VERIFIED' | 'SESSION_END' | 'SESSION_FAILED' | 'SESSION_REFUSED' | 'SESSION_START';
+export type RuntimeEventAction = 'DELIVERY_READY' | 'DELIVERY_VERIFIED' | 'SESSION_CREATED' | 'SESSION_DISPOSED' | 'SESSION_FAILED' | 'SESSION_REFUSED' | 'SESSION_START';
 /**
  * 运行面上报：只接受用户密钥身份，动作码限闭集；detail 由服务端脱敏后落库。
- * 目标项目按 slug 解析：命中可读项目时 targetId 是项目 id，否则只留 slug 快照。
+ * 目标项目按 slug 解析：命中可读项目时挂项目 id，否则只留 slug 快照。
+ * 带会话身份（runRef 或 sessionId + clientId）的事件会折叠进同一行客户端会话。
  */
 export type RuntimeEventInput = {
     action: RuntimeEventAction;
-    /** 原因码 / 交付状态码（例 SETUP_FAILED、delivered）。 */
+    /** 运行面实例标识（插件进程内生成）：同名 dsh 会话在不同容器里靠它分开。 */
+    clientId?: string | null | undefined;
+    /** 原因码 / 交付状态码（例 SETUP_FAILED、delivered、dispose）。 */
     code?: string | null | undefined;
     detail?: unknown;
+    /** 会话使用的模型与档位（拿不到留空）。 */
+    modelId?: string | null | undefined;
     outcome: AuditOutcome;
-    /** 项目 slug（CNB 仓库 slug 或工作区目录名），用于把事件挂到项目上。 */
+    /** 项目 slug（CNB 仓库 slug 或已登记工作区 slug），用于把事件挂到项目上。 */
     projectSlug?: string | null | undefined;
+    reasoningLevel?: string | null | undefined;
+    /** 任务引用 `<repo>#<issue|pr>#<iid>`：NPC 一次任务的稳定身份，会话尚未创建也带。 */
+    runRef?: string | null | undefined;
+    /** dsh 会话 id（会话创建 / 销毁事件给出）。 */
+    sessionId?: string | null | undefined;
     /** 目标展示名（例 `issue-12` / `PR #34`）。 */
     targetLabel?: string | null | undefined;
+    /** 本次会话的 cwd 与命中的已登记工作区 slug。 */
+    workspacePath?: string | null | undefined;
+    workspaceSlug?: string | null | undefined;
 };
 /** 技能附件内容的编码：文本类用 UTF8，其余（图片 / 二进制）用 BASE64。 */
 export type SkillFileEncoding = 'BASE64' | 'UTF8';
@@ -86,6 +99,10 @@ export type RuntimeBootQuery = {
             isExecutable: boolean;
         }>;
     }> | null;
+    runtimeRedmine: {
+        baseUrl: string | null;
+        apiKey: string | null;
+    } | null;
 };
 export type RuntimeSkillFilesQueryVariables = Exact<{
     skillId: string | number;