@fa-software/semi2-dsh 0.0.14-preview.20260927035651 → 0.0.15

package/lib/service/publish.js

@@ -1,184 +0,0 @@
-import { statusFields, workspaceTabs, WORKSPACE_TABS_FIELD, } from "../hub/status.js";
-import { SEMI2_SETTINGS_ENTRY, userSection } from "./namespaces.js";
-import { HEALTH_FIELDS_SCHEMA_KEYS, STATUS_FIELDS } from "./settings-sections.js";
-import { aggregateHealth, healthText } from "./health.js";
-import { DOMAINS } from "./registry.js";
-import { reportEvent } from "./audit.js";
-/** 判成「没有读者」时的重判节奏与次数：热装瞬间服务可见性可能比插件激活晚。 */
-const PUBLISH_RECHECK_TRIES = 3;
-const PUBLISH_RECHECK_MS = 1_000;
-/** 状态行只由本插件写：盘上残留认领按这些键名判定（旧版本落过盘的展示键）。 */
-const OWNED_STATUS_KEYS = [
-    ...STATUS_FIELDS,
-    ...HEALTH_FIELDS_SCHEMA_KEYS,
-    WORKSPACE_TABS_FIELD,
-    'entries',
-];
-/** 发布失败只提示一次：每轮状态变化都喊一遍没有信息量。 */
-const warnedPublishFailure = new WeakSet();
-/** 盘上残留认领只做一次（每个进程一份引擎）。 */
-const claimedLegacy = new WeakSet();
-/**
- * 状态 + 健康 + 工作区 tab 一次发布：整份写进本插件设置段的运行期 config。
- * 盘上组合层由 `applyStatusRow` 原样带上，消费方写在同一行里的调参不会被冲掉。
- */
-export async function publishStatus(engine) {
-    // headless 应用（既无网页服务也无 dsh 工作区服务）没有读者：不发，也不留残渣。
-    if (!engine.ports.hasAudience())
-        return 'headless';
-    if (engine.settings() === undefined)
-        return 'headless';
-    const facts = {
-        credentialSource: engine.connection()?.source ?? null,
-        platform: engine.platform,
-        startupDir: engine.startupDir,
-    };
-    const slices = [];
-    for (const descriptor of DOMAINS) {
-        const domain = engine.domains.get(descriptor.id);
-        if (domain !== undefined)
-            slices.push(domain.statusFields(engine.state()));
-    }
-    const fields = statusFields(engine.state(), facts, slices);
-    const health = healthSnapshot(engine);
-    const section = {
-        ...fields,
-        ...Object.fromEntries(Object.entries(health).map(([key, item]) => [
-            key,
-            `${item.state}:${healthText(item)}`,
-        ])),
-        [WORKSPACE_TABS_FIELD]: workspaceTabs(engine.state()),
-    };
-    try {
-        // 到点降级：调用方不再等；内存行本身立即生效，超时只说明这一拍没赶上。
-        const applied = await within(engine.ports.applyStatusRow(SEMI2_SETTINGS_ENTRY, section), engine.writeTimeoutMs);
-        return applied === true ? 'applied' : 'failed';
-    }
-    catch (error) {
-        if (!warnedPublishFailure.has(engine)) {
-            warnedPublishFailure.add(engine);
-            engine.warn(`状态段发布失败（${error instanceof Error ? error.message : String(error)}），状态不会下发`);
-        }
-        return 'failed';
-    }
-}
-/**
- * 旧版本把状态段写进过 profile patch：启动后按名字认领一次，只撤下本插件写过的展示键，
- * 消费方设在同一行里的调参原样留着。这是本插件唯一的落盘写；失败只 warn，下轮再试。
- */
-export async function dropLegacyStatusRow(engine) {
-    if (claimedLegacy.has(engine))
-        return;
-    const settings = engine.settings();
-    if (settings === undefined)
-        return;
-    const leftover = Object.keys(userSection(settings, SEMI2_SETTINGS_ENTRY))
-        .filter(key => OWNED_STATUS_KEYS.includes(key));
-    if (leftover.length === 0) {
-        claimedLegacy.add(engine);
-        return;
-    }
-    try {
-        await engine.ports.clearKeys(settings, SEMI2_SETTINGS_ENTRY, leftover);
-        claimedLegacy.add(engine);
-        engine.warn('盘上 semi2-dsh 还留着旧版本的状态段，已撤下并改按运行期内存行发布');
-    }
-    catch (error) {
-        engine.warn(`盘上状态段残留清理失败（${error instanceof Error ? error.message : String(error)}），下轮再试`);
-    }
-}
-/** 领域在会话期产生新状态时请求一次发布：fire-and-forget，失败只 warn，不影响会话。 */
-export function scheduleStatusPublish(engine) {
-    void publishStatus(engine)
-        .then((outcome) => {
-        if (outcome !== 'applied')
-            schedulePublishRecheck(engine, 1);
-    })
-        .catch((error) => {
-        engine.warn(`状态发布失败（${error instanceof Error ? error.message : String(error)}）`);
-    });
-}
-/** 有界重判：没发出去（服务晚到场 / 条目还没挂上）时按 PUBLISH_RECHECK_* 给的节奏与次数重判。 */
-function schedulePublishRecheck(engine, attempt) {
-    if (attempt > PUBLISH_RECHECK_TRIES)
-        return;
-    const timer = globalThis.setTimeout(() => {
-        void publishStatus(engine).then((outcome) => {
-            if (outcome !== 'applied')
-                schedulePublishRecheck(engine, attempt + 1);
-        }, () => {
-            // 重判失败不排下一轮：下一次状态变化会重新发布。
-        });
-    }, PUBLISH_RECHECK_MS);
-    timer.unref();
-}
-/** 到点返回 `'expired'`，否则原样给出结果（超时不取消：调用方降级，写入照常落定）。 */
-async function within(promise, ms) {
-    let timer;
-    try {
-        return await Promise.race([
-            promise,
-            new Promise((resolve) => {
-                timer = globalThis.setTimeout(() => {
-                    resolve('expired');
-                }, ms);
-            }),
-        ]);
-    }
-    finally {
-        if (timer !== undefined)
-            globalThis.clearTimeout(timer);
-    }
-}
-/** 整体读取失败：只落 state.error 与失败态，不注入任何配置（可重载重试）。 */
-export async function publishFailed(engine, code) {
-    engine.patchState({
-        status: 'failed',
-        error: code,
-        workspaces: engine.workspace().tracked(),
-    });
-    engine.emitConfigUpdated();
-    // 失败也必须发布：登录成功但同步失败时，错误码是唯一提示（客户端按 error 渲染「最近失败」）。
-    await publishStatus(engine);
-    // 启动期的整体失败落一条运行端事件：判「本端起没起来」不必翻容器日志。
-    await reportEvent(engine, {
-        action: 'SESSION_FAILED',
-        outcome: 'ERROR',
-        code,
-    });
-}
-/** boot 事实 → ready 状态（技能切片取自 skills 领域；项目缓存随装配作废，由工作区同步重取）。 */
-export function appliedState(engine, boot, compiled, errorCode) {
-    const defaultModelId = boot.runtimeDefaultModelId ?? null;
-    const selection = compiled === null || defaultModelId === null
-        ? null
-        : (compiled.selections.get(defaultModelId) ?? null);
-    const skills = engine.peer('skills')?.skills() ?? null;
-    const current = engine.state();
-    return {
-        ...current,
-        status: 'ready',
-        error: errorCode,
-        consoleUrl: engine.connection()?.url ?? current.consoleUrl,
-        loadedAt: new Date().toISOString(),
-        identity: boot.runtimeViewer ?? null,
-        model: selection === null
-            ? null
-            : { id: selection.model, provider: selection.provider },
-        skills,
-        projects: [],
-    };
-}
-/** 健康快照：领域项按注册表（缺席记 unavailable）+ 能力贡献者按登记。 */
-export function healthSnapshot(engine) {
-    return aggregateHealth(DOMAINS.map(domain => domain.id), (id) => {
-        // 本端没有 settings 服务：没有任何领域被装配（写不进去就不装），整端记不适用。
-        if (engine.settingsMissing()) {
-            return { state: 'unavailable', note: '本端无 settings 服务，不注入配置' };
-        }
-        const domain = engine.domains.get(id);
-        if (domain === undefined)
-            return { state: 'unavailable', note: '本端不提供该能力（依赖缺席）' };
-        return domain.health();
-    }, engine.healthContributorsView());
-}

package/lib/service/settings-sections.js

@@ -1,40 +0,0 @@
-// @fa-software/semi2-dsh/service/settings-sections —— 插件自身设置段的字段声明（按注册表聚合生成）。
-// dsh 的设置段 = Profile 插件条目（id = `SEMI2_SETTINGS_ENTRY`）：只有声明为 volatile 的字段才会被
-// `describe()` 看见、才能实时写，所以状态 / 健康 / 工作区 tab 全部在这里声明（内容由状态行经内存覆盖
-// 写进去，不落盘）；数值旋钮不在此列——它们是加载期参数，改动理应重挂载；模型路由也不在此列——它们走内存覆盖行。
-import z from '@deepseek-ai/schemastery';
-import { STATUS_BASE_FIELDS, WORKSPACE_TABS_FIELD } from "../hub/status.js";
-import { DOMAINS } from "./registry.js";
-/** 完整状态字段顺序（基座 + 按注册表顺序的领域字段）；UI 与健康字段共用这一段。 */
-export const STATUS_FIELDS = [
-    ...STATUS_BASE_FIELDS,
-    ...DOMAINS.flatMap(domain => [...domain.statusKeys]),
-];
-/** 健康字段 schema 键（能力 + 领域，值是 `ok:正常` 形式的编码串；读侧拆码）。 */
-export const HEALTH_FIELDS_SCHEMA_KEYS = [
-    'healthWeb',
-    ...DOMAINS.map(domain => `health:${domain.id}`),
-];
-/** tab 列表字段：结构化数组（界面按作用域渲染用；扁平字符串继续留给纯文本展示）。 */
-const WORKSPACE_TABS_SCHEMA = z
-    .array(z.object({
-    slug: z.string().default(''),
-    title: z.string().default(''),
-    projectId: z.string().default(''),
-    project: z.string().default(''),
-    syncedAt: z.string().default(''),
-    implicit: z.boolean().default(false),
-}))
-    .default([]);
-/** 一个字段表 → 全部置 volatile（整体一个可实时写的节点，子路径共用该性质）。 */
-function allVolatile(fields) {
-    return Object.fromEntries(Object.entries(fields).map(([key, field]) => [key, field.volatile()]));
-}
-/** 插件 Config 的可写字段表（并入入口的 Config schema）；写入只走 volatile 路径。 */
-export const STATE_CONFIG_FIELDS = {
-    ...allVolatile(Object.fromEntries([...STATUS_FIELDS, ...HEALTH_FIELDS_SCHEMA_KEYS].map(key => [
-        key,
-        z.string().default(''),
-    ]))),
-    [WORKSPACE_TABS_FIELD]: WORKSPACE_TABS_SCHEMA.volatile(),
-};

package/lib/types/service/publish.d.ts

@@ -1,24 +0,0 @@
-import type { RuntimeBootFacts } from '../api/index.ts';
-import type { LoadRun } from '../domains/types.ts';
-import type { Semi2ConfigState } from '../hub/facts.ts';
-import type { OrchestratorInternals } from './orchestrator.ts';
-/** 发布结果：`headless` = 本端没有读者（不发），供端的有界重判使用。 */
-export type PublishOutcome = 'applied' | 'failed' | 'headless';
-/**
- * 状态 + 健康 + 工作区 tab 一次发布：整份写进本插件设置段的运行期 config。
- * 盘上组合层由 `applyStatusRow` 原样带上，消费方写在同一行里的调参不会被冲掉。
- */
-export declare function publishStatus(engine: OrchestratorInternals): Promise<PublishOutcome>;
-/**
- * 旧版本把状态段写进过 profile patch：启动后按名字认领一次，只撤下本插件写过的展示键，
- * 消费方设在同一行里的调参原样留着。这是本插件唯一的落盘写；失败只 warn，下轮再试。
- */
-export declare function dropLegacyStatusRow(engine: OrchestratorInternals): Promise<void>;
-/** 领域在会话期产生新状态时请求一次发布：fire-and-forget，失败只 warn，不影响会话。 */
-export declare function scheduleStatusPublish(engine: OrchestratorInternals): void;
-/** 整体读取失败：只落 state.error 与失败态，不注入任何配置（可重载重试）。 */
-export declare function publishFailed(engine: OrchestratorInternals, code: string): Promise<void>;
-/** boot 事实 → ready 状态（技能切片取自 skills 领域；项目缓存随装配作废，由工作区同步重取）。 */
-export declare function appliedState(engine: OrchestratorInternals, boot: RuntimeBootFacts, compiled: LoadRun['compiled'], errorCode: string | null): Semi2ConfigState;
-/** 健康快照：领域项按注册表（缺席记 unavailable）+ 能力贡献者按登记。 */
-export declare function healthSnapshot(engine: OrchestratorInternals): import("./health.ts").HealthSnapshot;

package/lib/types/service/settings-sections.d.ts

@@ -1,7 +0,0 @@
-import z from '@deepseek-ai/schemastery';
-/** 完整状态字段顺序（基座 + 按注册表顺序的领域字段）；UI 与健康字段共用这一段。 */
-export declare const STATUS_FIELDS: readonly string[];
-/** 健康字段 schema 键（能力 + 领域，值是 `ok:正常` 形式的编码串；读侧拆码）。 */
-export declare const HEALTH_FIELDS_SCHEMA_KEYS: readonly string[];
-/** 插件 Config 的可写字段表（并入入口的 Config schema）；写入只走 volatile 路径。 */
-export declare const STATE_CONFIG_FIELDS: Record<string, z>;