dominds 1.5.2 → 1.6.0

package/dist/docs/app-constitution.md

@@ -206,6 +206,19 @@ Recommended user mental model:
 - If `configuration.yaml` is missing, strategy falls back to defaults (`order=['local']`, `localRoots=['dominds-apps']`) and no explicit disables apply.
 - If `resolution.yaml` is missing, the snapshot starts empty and the kernel re-materializes it from the declared dependency graph.
 
+(Current: implemented) self-heal behavior for common entrypoints is:
+
+- `dominds webui`: the server startup path initializes apps runtime and re-materializes `<rtws>/.apps/resolution.yaml`.
+- `dominds tui` / `dominds run`: before entering interactive runtime, Dominds refreshes enabled-app runtime/tool proxies and re-materializes `resolution.yaml`.
+- `dominds read` / `dominds manual`: Dominds refreshes enabled app tool proxies first; if the root manifest still declares dependencies, this also re-materializes `resolution.yaml`.
+
+Self-heal only works when both prerequisites hold:
+
+- root `.minds/app.yaml` still declares the correct app id (for example `web-dev`), and
+- the current resolution strategy can actually resolve that app (for example, default `localRoots=['dominds-apps']` contains `dominds-apps/web-dev/`, and that package's install handshake / manifest also declares the same app id).
+
+If the root manifest / team config uses the wrong app id (for example, still declaring the legacy id `web_dev` inside `dependencies[].id` or `members.<id>.from` while the app now installs as `web-dev`), refresh will still re-materialize `resolution.yaml` as empty. That means self-heal did run; it just correctly recomputed an empty result from incorrect source declarations.
+
 So even without `<rtws>/.apps/configuration.yaml` or `<rtws>/.apps/resolution.yaml`, as long as `.minds/app.yaml` declares dependencies, the kernel still resolves local apps via the default strategy; if the root manifest has no dependencies, the effective enabled apps set is empty.
 
 ## App-provided `.minds/**` assets
@@ -306,6 +319,14 @@ dominds install ./dominds-apps/web-dev --local --enable
 dominds install @longrun-ai/web-dev --enable
 ```
 
+Web Dev App needs three names kept distinct to avoid drift:
+
+- installable app id: `web-dev`
+- local development directory: `dominds-apps/web-dev/`
+- npm package name: `@longrun-ai/web-dev`
+
+That means workspace `.minds/app.yaml` `dependencies[].id`, `.minds/team.yaml` `members.<id>.from`, and `<rtws>/.apps/resolution.yaml` `apps[].id` must all use `web-dev`; the directory and package naming surfaces also stay `web-dev` so the app no longer carries two spellings.
+
 After installation, the user should expect these files to change:
 
 - `.minds/app.yaml`: root dependency declaration is updated.
@@ -380,6 +401,7 @@ Requirements for the `playwright_interactive` toolset design:
 Current prototype note (`dominds-apps/web-dev`, as of March 8, 2026):
 
 - The app is already installable and contributes `web_tester` / `web_developer` teammates plus a live `playwright_interactive` toolset registration.
+- The installable app id remains `web-dev`; the directory name and npm package also keep the same `web-dev` spelling so the app no longer carries split naming.
 - `playwright_session_new/list/status/eval/attach/detach/close` and cross-dialog reminder sync are already implemented.
 - `kind: "web"` sessions now create a real Playwright-backed browser/context/page runtime and report live page surfaces via session status/reminders.
 - `kind: "electron"` is **not** at the same completion level yet: it still falls back to the older prototype runtime path and should be treated as unfinished.

package/dist/docs/app-constitution.zh.md

@@ -205,6 +205,19 @@ rtws 是一次运行的工作区根目录（`process.cwd()`）。Kernel 在其
 - 若 `configuration.yaml` 缺失：strategy 使用默认值（`order=['local']`，`localRoots=['dominds-apps']`），且没有显式 disable。
 - 若 `resolution.yaml` 缺失：视为空快照，Kernel 会根据当前声明依赖重新解析并写回结果。
 
+（现状：已实现）常规入口的自愈口径如下：
+
+- `dominds webui`：server 启动链会初始化 apps runtime，并重新物化 `<rtws>/.apps/resolution.yaml`。
+- `dominds tui` / `dominds run`：进入交互 runtime 前会刷新 enabled apps runtime / tool proxies，并重新物化 `resolution.yaml`。
+- `dominds read` / `dominds manual`：会先刷新 enabled app tool proxies；若根 manifest 仍声明依赖，也会触发 `resolution.yaml` 的重新物化。
+
+自愈成立的前提必须同时满足：
+
+- 根 `.minds/app.yaml` 仍声明了正确的 app id（例如 `web-dev`）。
+- 当前 resolution strategy 能解析到对应 app（例如默认 `localRoots=['dominds-apps']` 下存在 `dominds-apps/web-dev/`，且该包的 install handshake / manifest 也声明同一个 app id）。
+
+若根 manifest / team.yaml 使用了错误的 app id（例如 app 已改为 `web-dev`，但 `dependencies[].id` 或 `members.<id>.from` 里仍保留 legacy `web_dev`），那么 refresh 仍会把 `resolution.yaml` 重新物化为空；这不是“自愈没跑”，而是“它按错误声明正确地重算出了空结果”。
+
 因此，即使缺少 `<rtws>/.apps/configuration.yaml` 或 `<rtws>/.apps/resolution.yaml`，只要 `.minds/app.yaml` 声明了依赖，Kernel 仍会按默认策略去解析本地 app；反之若根 manifest 没有依赖，则最终 enabled apps 为空。
 
 ## App 可提供的 `.minds/**` 资产
@@ -304,6 +317,14 @@ dominds install ./dominds-apps/web-dev --local --enable
 dominds install @longrun-ai/web-dev --enable
 ```
 
+Web Dev App 需要明确区分三套命名，避免再次漂移：
+
+- installable app id：`web-dev`
+- 本地开发目录：`dominds-apps/web-dev/`
+- npm package name：`@longrun-ai/web-dev`
+
+也就是说，workspace `.minds/app.yaml` 的 `dependencies[].id`、`.minds/team.yaml` 的 `members.<id>.from`，以及 `<rtws>/.apps/resolution.yaml` 的 `apps[].id` 都应使用 `web-dev`；目录名与 package name 也统一保持 `web-dev`，避免同一 app 在不同层面出现双拼写。
+
 安装完成后，用户应预期以下文件发生变化：
 
 - `.minds/app.yaml`：增加根依赖声明。
@@ -378,6 +399,7 @@ members:
 当前 prototype 说明（`dominds-apps/web-dev`，截至 2026-03-08）：
 
 - 该 app 已可安装，并已贡献 `web_tester` / `web_developer` teammate 与可用的 `playwright_interactive` toolset 注册。
+- installable app id 当前固定为 `web-dev`；目录名与 npm package 名也保持 `web-dev`，避免多套命名并存。
 - `playwright_session_new/list/status/eval/attach/detach/close` 与跨对话 reminder sync 已落地。
 - `kind: "web"` 会话现在会创建真实的 Playwright browser/context/page runtime，并通过 status/reminder 报告实时页面 surface。
 - `kind: "electron"` 还没有达到同等完成度：当前仍回落到旧的 prototype runtime 路径，应视为未完成能力。

package/dist/llm/kernel-driver/runtime.js

@@ -265,6 +265,32 @@ function isRetriableLlmErrorCode(code) {
         return false;
     return RETRIABLE_LLM_ERROR_CODES.has(code);
 }
+function isOpenAiRetriableProcessingFailureMessage(lowerMessage) {
+    if (!lowerMessage.includes('processing your request')) {
+        return false;
+    }
+    if (lowerMessage.includes('you can retry your request') ||
+        lowerMessage.includes('please retry your request')) {
+        return true;
+    }
+    return lowerMessage.includes('help.openai.com') && lowerMessage.includes('request id');
+}
+function isRetriableLlmMessage(message) {
+    const lower = message.toLowerCase();
+    if (lower.includes('fetch failed') || lower.includes('socket hang up')) {
+        return true;
+    }
+    if (lower.includes('terminated')) {
+        return true;
+    }
+    if (lower.includes('timeout') || lower.includes('timed out') || lower.includes('rate limit')) {
+        return true;
+    }
+    if (isOpenAiRetriableProcessingFailureMessage(lower)) {
+        return true;
+    }
+    return false;
+}
 function classifyLlmFailure(err) {
     const fallbackMessage = err instanceof Error
         ? err.message || err.name
@@ -292,16 +318,7 @@ function classifyLlmFailure(err) {
                 ? err
                 : undefined;
         if (typeof msg === 'string' && msg.length > 0) {
-            const lower = msg.toLowerCase();
-            if (lower.includes('fetch failed') || lower.includes('socket hang up')) {
-                return { kind: 'retriable', code: errCode ?? causeCode, message: msg };
-            }
-            if (lower.includes('terminated')) {
-                return { kind: 'retriable', code: errCode ?? causeCode, message: msg };
-            }
-            if (lower.includes('timeout') ||
-                lower.includes('timed out') ||
-                lower.includes('rate limit')) {
+            if (isRetriableLlmMessage(msg)) {
                 return { kind: 'retriable', code: errCode ?? causeCode, message: msg };
             }
         }
@@ -327,14 +344,7 @@ function classifyLlmFailure(err) {
         if (isRetriableLlmErrorCode(code)) {
             return { kind: 'retriable', code, message: msg };
         }
-        const lower = msg.toLowerCase();
-        if (lower.includes('fetch failed') || lower.includes('socket hang up')) {
-            return { kind: 'retriable', code: code ?? causeCode, message: msg };
-        }
-        if (lower.includes('terminated')) {
-            return { kind: 'retriable', code: code ?? causeCode, message: msg };
-        }
-        if (lower.includes('timeout') || lower.includes('timed out') || lower.includes('rate limit')) {
+        if (isRetriableLlmMessage(msg)) {
             return { kind: 'retriable', code: code ?? causeCode, message: msg };
         }
     }
@@ -399,8 +409,23 @@ async function runLlmRequestWithRetry(params) {
     const retryInitialDelayMs = normalizeRetryInitialDelayMs(params.retryInitialDelayMs);
     const retryBackoffMultiplier = normalizeRetryBackoffMultiplier(params.retryBackoffMultiplier);
     const retryMaxDelayMs = normalizeRetryMaxDelayMs(params.retryMaxDelayMs, retryInitialDelayMs);
+    const retryFlowStartedAtMs = Date.now();
+    let activeRetryContext;
     for (let attempt = 0; attempt <= params.maxRetries; attempt++) {
         try {
+            if (attempt > 0 && activeRetryContext) {
+                emitLlmRetryEventBestEffort({
+                    dlg: params.dlg,
+                    phase: 'running',
+                    provider: params.provider,
+                    attempt: attempt + 1,
+                    totalAttempts,
+                    maxRetries: params.maxRetries,
+                    retriesRemaining: Math.max(0, params.maxRetries - attempt),
+                    failure: activeRetryContext.failure,
+                    errorText: activeRetryContext.errorText,
+                });
+            }
             const res = await params.doRequest();
             (0, problems_1.removeProblem)(providerProblemId);
             return res;
@@ -496,14 +521,26 @@ async function runLlmRequestWithRetry(params) {
                 catch {
                     // best-effort
                 }
-                throw new Error(canRetry
-                    ? `LLM failed after retries: ${failure.message}`
-                    : `LLM failed: ${failure.message}`);
+                if (canRetry) {
+                    const interruptionDetail = formatLlmRetryExhaustedInterruptionDetail({
+                        language: params.dlg.getLastUserLanguageCode(),
+                        provider: params.provider,
+                        totalAttempts,
+                        maxRetries: params.maxRetries,
+                        elapsedMs: Date.now() - retryFlowStartedAtMs,
+                        retryInitialDelayMs,
+                        retryBackoffMultiplier,
+                        retryMaxDelayMs,
+                        errorText: detail,
+                    });
+                    throw new Error(interruptionDetail);
+                }
+                throw new Error(`LLM failed: ${failure.message}`);
             }
             const backoffMs = Math.min(retryMaxDelayMs, Math.max(0, Math.floor(retryInitialDelayMs * retryBackoffMultiplier ** attempt)));
             emitLlmRetryEventBestEffort({
                 dlg: params.dlg,
-                phase: 'retrying',
+                phase: 'waiting',
                 provider: params.provider,
                 attempt: attemptNo,
                 totalAttempts,
@@ -513,6 +550,10 @@ async function runLlmRequestWithRetry(params) {
                 failure,
                 errorText: detail,
             });
+            activeRetryContext = {
+                failure,
+                errorText: detail,
+            };
             log_1.log.warn(`Retrying LLM request after retriable error`, undefined, {
                 provider: params.provider,
                 attempt: attemptNo,
@@ -531,3 +572,52 @@ async function runLlmRequestWithRetry(params) {
     }
     throw new Error('LLM failed.');
 }
+function formatRetryElapsedDuration(language, elapsedMsRaw) {
+    const elapsedMs = Math.max(0, Math.floor(elapsedMsRaw));
+    if (elapsedMs < 1000) {
+        return `${elapsedMs}ms`;
+    }
+    const totalSeconds = elapsedMs / 1000;
+    if (totalSeconds < 60) {
+        const text = totalSeconds >= 10 ? totalSeconds.toFixed(1) : totalSeconds.toFixed(2);
+        return language === 'zh' ? `${text} 秒` : `${text}s`;
+    }
+    const wholeSeconds = Math.round(totalSeconds);
+    const minutes = Math.floor(wholeSeconds / 60);
+    const seconds = wholeSeconds % 60;
+    if (language === 'zh') {
+        return seconds === 0 ? `${minutes} 分钟` : `${minutes} 分 ${seconds} 秒`;
+    }
+    return seconds === 0 ? `${minutes}m` : `${minutes}m ${seconds}s`;
+}
+function formatLlmRetryExhaustedInterruptionDetail(args) {
+    const providerPath = `providers.${args.provider}`;
+    const durationText = formatRetryElapsedDuration(args.language, args.elapsedMs);
+    const trimmedError = args.errorText.trim();
+    if (args.language === 'zh') {
+        return (`LLM 自动重试已耗尽：provider=${args.provider}，共尝试 ${args.totalAttempts} 次` +
+            `（初始请求 1 次 + 重试 ${args.maxRetries} 次），总耗时 ${durationText}。` +
+            `当前重试配置：llm_retry_max_retries=${args.maxRetries}，` +
+            `llm_retry_initial_delay_ms=${args.retryInitialDelayMs}，` +
+            `llm_retry_backoff_multiplier=${args.retryBackoffMultiplier}，` +
+            `llm_retry_max_delay_ms=${args.retryMaxDelayMs}。` +
+            `若想增加重试次数或拉长重试间隔，请编辑 \`.minds/llm.yaml\` 中的 ` +
+            `\`${providerPath}.llm_retry_max_retries\`、` +
+            `\`${providerPath}.llm_retry_initial_delay_ms\`、` +
+            `\`${providerPath}.llm_retry_backoff_multiplier\`、` +
+            `\`${providerPath}.llm_retry_max_delay_ms\`，并检查 provider / network 稳定性。` +
+            `最后错误：${trimmedError}`);
+    }
+    return (`LLM automatic retries exhausted: provider=${args.provider}, ${args.totalAttempts} attempts total ` +
+        `(1 initial request + ${args.maxRetries} retries), elapsed ${durationText}. ` +
+        `Current retry config: llm_retry_max_retries=${args.maxRetries}, ` +
+        `llm_retry_initial_delay_ms=${args.retryInitialDelayMs}, ` +
+        `llm_retry_backoff_multiplier=${args.retryBackoffMultiplier}, ` +
+        `llm_retry_max_delay_ms=${args.retryMaxDelayMs}. ` +
+        `If you want more retries or longer retry intervals, edit ` +
+        `\`.minds/llm.yaml\`: \`${providerPath}.llm_retry_max_retries\`, ` +
+        `\`${providerPath}.llm_retry_initial_delay_ms\`, ` +
+        `\`${providerPath}.llm_retry_backoff_multiplier\`, ` +
+        `\`${providerPath}.llm_retry_max_delay_ms\`, and verify provider/network stability. ` +
+        `Last error: ${trimmedError}`);
+}

package/dist/minds/load.js

@@ -11,6 +11,7 @@ const dialog_1 = require("../dialog");
 const log_1 = require("../log");
 const runtime_language_1 = require("../shared/runtime-language");
 const time_1 = require("../shared/utils/time");
+const load_1 = require("../skills/load");
 const team_1 = require("../team");
 const ctrl_1 = require("../tools/ctrl");
 const shell_tools_1 = require("../tools/shell-tools");
@@ -142,6 +143,15 @@ async function loadAgentMinds(agentId, dialog, options) {
     const knowledge = knowledgeRaw && knowledgeRaw.trim() !== '' ? knowledgeRaw : none;
     const lessons = lessonsRaw && lessonsRaw.trim() !== '' ? lessonsRaw : none;
     const envIntro = envIntroRaw && envIntroRaw.trim() !== '' ? envIntroRaw : '';
+    const workspaceSkills = await (0, load_1.loadWorkspaceSkills)({
+        rtwsRootAbs: process.cwd(),
+        memberId: agent.id,
+        language: workingLanguage,
+    });
+    const skillsText = (0, load_1.renderWorkspaceSkillsPrompt)({
+        language: workingLanguage,
+        skills: workspaceSkills,
+    });
     // Introduction of all team members (mark "(self)" for the current agent)
     const teamIntro = (0, system_prompt_1.formatTeamIntro)(team, agent.id, workingLanguage);
     // Compose tool list from member's resolved toolsets and tools + built-in human tool
@@ -149,8 +159,15 @@ async function loadAgentMinds(agentId, dialog, options) {
     // shell_specialists is intended for visible teammates only. Hidden members are exempt from this
     // policy and may carry shell tools.
     const agentIsShellSpecialist = team.shellSpecialists.includes(agent.id) || agent.hidden === true;
+    const dynamicToolsetNames = await team_1.Team.listDynamicToolsetNamesForMember({
+        member: agent,
+        taskDocPath: dialog?.taskDocPath,
+    });
     const baseAgentTools = (() => {
-        const tools = agent.listTools({ onMissingToolset: missingToolsetPolicy });
+        const tools = agent.listTools({
+            onMissingToolset: missingToolsetPolicy,
+            dynamicToolsetNames,
+        });
         if (agentIsShellSpecialist)
             return tools;
         return tools.filter((t) => !(t.type === 'func' && typeof t.name === 'string' && (0, shell_tools_1.isShellToolName)(t.name)));
@@ -179,7 +196,7 @@ async function loadAgentMinds(agentId, dialog, options) {
         return out;
     })();
     const toolsetNames = agent
-        .listResolvedToolsetNames({ onMissing: missingToolsetPolicy })
+        .listResolvedToolsetNames({ onMissing: missingToolsetPolicy, dynamicToolsetNames })
         .filter((name) => {
         if (name === 'os')
             return agentIsShellSpecialist;
@@ -247,6 +264,7 @@ async function loadAgentMinds(agentId, dialog, options) {
         persona,
         knowledge,
         lessons,
+        skillsText,
         envIntro,
         teamIntro,
         funcToolRulesText,

package/dist/minds/system-prompt.js

@@ -290,6 +290,8 @@ ${input.knowledge}
 
 ${input.lessons}
 
+${input.skillsText}
+
 ## 运行环境
 
 ${input.envIntro}
@@ -381,6 +383,8 @@ ${input.knowledge}
 
 ${input.lessons}
 
+${input.skillsText}
+
 ## Runtime Environment
 
 ${input.envIntro}

package/dist/priming.js

@@ -19,6 +19,7 @@ const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
 const yaml_1 = __importDefault(require("yaml"));
 const persistence_1 = require("./persistence");
+const markdown_frontmatter_1 = require("./shared/markdown-frontmatter");
 const storage_1 = require("./shared/types/storage");
 const time_1 = require("./shared/utils/time");
 const registry_1 = require("./tools/registry");
@@ -108,33 +109,8 @@ function scriptRefToAbsolutePath(scriptRef) {
     }
     return absPath;
 }
-function stripOptionalBom(text) {
-    if (text.charCodeAt(0) === 0xfeff) {
-        return text.slice(1);
-    }
-    return text;
-}
 function parseFrontmatter(raw) {
-    const normalized = stripOptionalBom(raw).replace(/\r\n/g, '\n');
-    if (!normalized.startsWith('---\n')) {
-        return { body: normalized, frontmatter: {} };
-    }
-    const endWithBody = normalized.indexOf('\n---\n', 4);
-    const endAtEof = normalized.endsWith('\n---') ? normalized.length - '\n---'.length : -1;
-    const end = endWithBody >= 0 ? endWithBody : endAtEof;
-    if (end < 0)
-        return { body: normalized, frontmatter: {} };
-    const frontmatterText = normalized.slice(4, end);
-    const body = endWithBody >= 0
-        ? normalized.slice(end + '\n---\n'.length)
-        : normalized.slice(end + '\n---'.length);
-    try {
-        const parsed = yaml_1.default.parse(frontmatterText);
-        return { body, frontmatter: isRecord(parsed) ? parsed : {} };
-    }
-    catch (error) {
-        throw new Error(`Invalid priming frontmatter: ${error instanceof Error ? error.message : String(error)}`);
-    }
+    return (0, markdown_frontmatter_1.parseMarkdownFrontmatter)(raw, 'priming');
 }
 function parseApplicableMemberIds(frontmatter) {
     const raw = frontmatter['applicableMemberIds'] ?? frontmatter['applicable_members'];

package/dist/server/websocket-handler.js

@@ -1344,6 +1344,11 @@ function setupWebSocketServer(httpServer, clients, auth, serverWorkLanguage) {
         }
     });
     (0, team_config_updates_1.startTeamConfigWatcher)();
+    httpServer.once('close', () => {
+        (0, team_config_updates_1.stopTeamConfigWatcher)();
+        (0, team_config_updates_1.clearTeamConfigBroadcaster)();
+        void wss.close();
+    });
     wss.on('connection', (ws, req) => {
         const authCheck = (0, auth_1.getWebSocketAuthCheck)(req, auth);
         if (authCheck.kind !== 'ok') {

package/dist/server.js

@@ -105,6 +105,7 @@ async function startServer(opts = {}) {
     const mode = opts.mode || 'prod';
     const port = opts.port ?? 5666;
     const host = opts.host || '127.0.0.1';
+    const startBackendDriver = opts.startBackendDriver ?? true;
     log.info(`Starting server in ${mode} mode on ${host}:${port} (working language: ${(0, runtime_language_1.getWorkLanguage)()} from ${source})`);
     // WebSocket clients set
     const clients = new Set();
@@ -131,8 +132,10 @@ async function startServer(opts = {}) {
     await (0, runtime_1.initAppsRuntime)({ rtwsRootAbs: process.cwd(), kernel: { host, port } });
     // Crash recovery: any dialogs left in "proceeding" state are surfaced as interrupted/resumable.
     await (0, dialog_run_state_1.reconcileRunStatesAfterRestart)();
-    // Start backend driver loop (non-blocking)
-    void (0, kernel_driver_1.runBackendDriver)();
+    // Tests may opt out so the process can shut down cleanly without a driver stop API.
+    if (startBackendDriver) {
+        void (0, kernel_driver_1.runBackendDriver)();
+    }
     // Start listening
     await httpServer.start();
     return { httpServer, auth, host, port, mode };

package/dist/shared/markdown-frontmatter.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripOptionalBom = stripOptionalBom;
+exports.normalizeMarkdownText = normalizeMarkdownText;
+exports.parseMarkdownFrontmatter = parseMarkdownFrontmatter;
+const yaml_1 = __importDefault(require("yaml"));
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function stripOptionalBom(text) {
+    if (text.charCodeAt(0) === 0xfeff) {
+        return text.slice(1);
+    }
+    return text;
+}
+function normalizeMarkdownText(text) {
+    return stripOptionalBom(text).replace(/\r\n/g, '\n');
+}
+function parseMarkdownFrontmatter(raw, sourceLabel = 'markdown') {
+    const normalized = normalizeMarkdownText(raw);
+    if (!normalized.startsWith('---\n')) {
+        return { body: normalized, frontmatter: {} };
+    }
+    const endWithBody = normalized.indexOf('\n---\n', 4);
+    const endAtEof = normalized.endsWith('\n---') ? normalized.length - '\n---'.length : -1;
+    const end = endWithBody >= 0 ? endWithBody : endAtEof;
+    if (end < 0) {
+        return { body: normalized, frontmatter: {} };
+    }
+    const frontmatterText = normalized.slice(4, end);
+    const body = endWithBody >= 0
+        ? normalized.slice(end + '\n---\n'.length)
+        : normalized.slice(end + '\n---'.length);
+    try {
+        const parsed = yaml_1.default.parse(frontmatterText);
+        return { body, frontmatter: isRecord(parsed) ? parsed : {} };
+    }
+    catch (error) {
+        throw new Error(`Invalid ${sourceLabel} frontmatter: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}

package/dist/shared/team_mgmt-manual.js

@@ -25,6 +25,7 @@ exports.TEAM_MGMT_MANUAL_TOPIC_KEYS = [
     'team',
     'member-properties',
     'minds',
+    'skills',
     'priming',
     'env',
     'permissions',
@@ -48,6 +49,9 @@ exports.TEAM_MGMT_MANUAL_TOPIC_META = {
     minds: {
         titleI18n: { zh: '角色资产（.minds/team/<id>/*）', en: 'Minds Assets (.minds/team/<id>/*)' },
     },
+    skills: {
+        titleI18n: { zh: '技能（.minds/skills/*）', en: 'Skills (.minds/skills/*)' },
+    },
     priming: {
         titleI18n: {
             zh: '启动脚本（.minds/priming/*）',
@@ -77,6 +81,7 @@ exports.TEAM_MGMT_MANUAL_UI_TOPIC_ORDER = [
     'builtin-defaults',
     'mcp',
     'minds',
+    'skills',
     'priming',
     'env',
     'troubleshooting',
@@ -97,6 +102,7 @@ exports.TEAM_MGMT_MANUAL_UI_TOOL_TOPICS_BY_KEY = {
     // Other
     mcp: ['mcp'],
     minds: ['minds'],
+    skills: ['skills'],
     priming: ['priming'],
     env: ['env'],
     troubleshooting: ['troubleshooting'],
@@ -106,6 +112,7 @@ exports.TEAM_MGMT_MANUAL_PANEL_TOPIC_ORDER = [
     'permissions',
     'team',
     'toolsets',
+    'skills',
 ];
 const EMPTY_TOOL_TOPICS = [];
 exports.TEAM_MGMT_MANUAL_PANEL_TOOL_TOPICS_BY_KEY = {
@@ -113,6 +120,7 @@ exports.TEAM_MGMT_MANUAL_PANEL_TOOL_TOPICS_BY_KEY = {
     permissions: ['permissions'],
     team: ['team'],
     toolsets: ['toolsets'],
+    skills: ['skills'],
 };
 function isTeamMgmtManualPanelTopicKey(value) {
     return Object.prototype.hasOwnProperty.call(exports.TEAM_MGMT_MANUAL_PANEL_TOOL_TOPICS_BY_KEY, value);
@@ -122,6 +130,7 @@ exports.TEAM_MGMT_MANUAL_PANEL_TOPIC_META = {
     permissions: exports.TEAM_MGMT_MANUAL_TOPIC_META.permissions,
     team: exports.TEAM_MGMT_MANUAL_TOPIC_META.team,
     toolsets: exports.TEAM_MGMT_MANUAL_TOPIC_META.toolsets,
+    skills: exports.TEAM_MGMT_MANUAL_TOPIC_META.skills,
 };
 function getTeamMgmtManualPanelTopicTitle(lang, key) {
     const meta = exports.TEAM_MGMT_MANUAL_PANEL_TOPIC_META[key];