@daweifu/capability-menu 0.1.1 → 0.1.2

package/lib/server/remote.js

@@ -33,8 +33,11 @@ var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn,
     done = true;
 };
 import { TypertRemoteService, Remote } from '@deepseek-ai/dsh-typert-protocol';
+import { readFile } from 'node:fs/promises';
+import yaml from 'js-yaml';
+import { BUILT_IN_SERVER } from "../registry.js";
 /**
- * Host-side remote face for the 能力菜单 tab. Every method delegates to the
+ * Host-side remote face for the 能力管理 tab. Every method delegates to the
  * policy service installed by `@daweifu/capability-menu/policy`; the registry
  * sibling (`capability`) must be mounted for `classifyAll` to return anything.
  *
@@ -53,6 +56,7 @@ let CapabilityPolicyGateway = (() => {
     let _getDetail_decorators;
     let _listSkillDir_decorators;
     let _readSkillFile_decorators;
+    let _getCatalogDocs_decorators;
     return class CapabilityPolicyGateway extends _classSuper {
         static {
             const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
@@ -62,12 +66,14 @@ let CapabilityPolicyGateway = (() => {
             _getDetail_decorators = [Remote('getDetail')];
             _listSkillDir_decorators = [Remote('listSkillDir')];
             _readSkillFile_decorators = [Remote('readSkillFile')];
+            _getCatalogDocs_decorators = [Remote('getCatalogDocs')];
             __esDecorate(this, null, _getConfig_decorators, { kind: "method", name: "getConfig", static: false, private: false, access: { has: obj => "getConfig" in obj, get: obj => obj.getConfig }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _updateConfig_decorators, { kind: "method", name: "updateConfig", static: false, private: false, access: { has: obj => "updateConfig" in obj, get: obj => obj.updateConfig }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _classifyAll_decorators, { kind: "method", name: "classifyAll", static: false, private: false, access: { has: obj => "classifyAll" in obj, get: obj => obj.classifyAll }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _getDetail_decorators, { kind: "method", name: "getDetail", static: false, private: false, access: { has: obj => "getDetail" in obj, get: obj => obj.getDetail }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _listSkillDir_decorators, { kind: "method", name: "listSkillDir", static: false, private: false, access: { has: obj => "listSkillDir" in obj, get: obj => obj.listSkillDir }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _readSkillFile_decorators, { kind: "method", name: "readSkillFile", static: false, private: false, access: { has: obj => "readSkillFile" in obj, get: obj => obj.readSkillFile }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _getCatalogDocs_decorators, { kind: "method", name: "getCatalogDocs", static: false, private: false, access: { has: obj => "getCatalogDocs" in obj, get: obj => obj.getCatalogDocs }, metadata: _metadata }, null, _instanceExtraInitializers);
             if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         }
         static inject = ['capabilityPolicy', 'capability'];
@@ -79,9 +85,9 @@ let CapabilityPolicyGateway = (() => {
         getConfig() {
             return this.ctx.capabilityPolicy.getConfig();
         }
-        /** Replace a subset of the policy config (recompile rules). */
-        updateConfig(partial) {
-            this.ctx.capabilityPolicy.updateConfig(partial);
+        /** Replace a subset of the policy config (recompile rules + rewrite catalog). */
+        async updateConfig(partial) {
+            await this.ctx.capabilityPolicy.updateConfig(partial);
         }
         /** Classify every capability currently indexed by `ctx.capability`. */
         classifyAll() {
@@ -99,6 +105,83 @@ let CapabilityPolicyGateway = (() => {
         async readSkillFile(id, relPath) {
             return this.ctx.capability.readSkillFile(id, relPath);
         }
+        /**
+         * 能力目录查看：返回「三档策略配置」语义化视图——默认全部常驻，
+         * tools.resident 按 server 各显示 '*'，例外（on-demand/disabled）按
+         * server → 工具短名 分级列出；skills 无 server 维度，resident 恒为 '*'，
+         * 例外为短名平铺。空例外不渲染 key，避免 []/{} 歧义。
+         * 另返回按需能力目录物化文件（~/.dsh/capability-catalog.yaml）的路径和内容。
+         * 两者都是只读视图——策略持久化入口仍是 cordis.patch.yml。
+         */
+        async getCatalogDocs() {
+            const effective = [...this.ctx.capabilityPolicy.classifyAll()];
+            const toolRows = effective.filter(row => row.kind === 'tool');
+            const skillRows = effective.filter(row => row.kind === 'skill');
+            const count = (rows, cls) => rows.filter(row => row.class === cls).length;
+            /** 例外档（on-demand/disabled）的生效工具，按 server 分组为 server → 短名列表。 */
+            const toolGroups = (cls) => {
+                const groups = new Map();
+                for (const row of toolRows.filter(r => r.class === cls)) {
+                    const server = row.server ?? BUILT_IN_SERVER;
+                    const prefix = row.server === undefined ? undefined : `mcp__${row.server}__`;
+                    const short = prefix !== undefined && row.name.startsWith(prefix) ? row.name.slice(prefix.length) : row.name;
+                    const list = groups.get(server);
+                    if (list === undefined)
+                        groups.set(server, [short]);
+                    else
+                        list.push(short);
+                }
+                return Object.fromEntries([...groups.entries()]
+                    .sort(([a], [b]) => a.localeCompare(b))
+                    .map(([server, names]) => [server, names.sort((a, b) => a.localeCompare(b))]));
+            };
+            /** 例外档技能的生效短名（技能无 server 维度，平铺列表）。 */
+            const skillNames = (cls) => skillRows.filter(row => row.class === cls).map(row => row.name).sort((a, b) => a.localeCompare(b));
+            // tools.resident：每个含工具的 server 一个 '*'（该 server 其余工具默认常驻）。
+            const servers = [...new Set(toolRows.map(row => row.server ?? BUILT_IN_SERVER))]
+                .sort((a, b) => a.localeCompare(b));
+            const residentTools = {};
+            for (const server of servers)
+                residentTools[server] = '*';
+            // 例外档仅当实际存在时才写入，避免空的 []/{}。
+            const tools = { resident: residentTools };
+            const onDemandTools = toolGroups('on-demand');
+            const disabledTools = toolGroups('disabled');
+            if (Object.keys(onDemandTools).length > 0)
+                tools['on-demand'] = onDemandTools;
+            if (Object.keys(disabledTools).length > 0)
+                tools.disabled = disabledTools;
+            const skills = { resident: '*' };
+            const onDemandSkills = skillNames('on-demand');
+            const disabledSkills = skillNames('disabled');
+            if (onDemandSkills.length > 0)
+                skills['on-demand'] = onDemandSkills;
+            if (disabledSkills.length > 0)
+                skills.disabled = disabledSkills;
+            const policyYaml = [
+                '# 能力管理 · 当前生效策略（只读；持久化入口：cordis.patch.yml）',
+                '# 语义：默认全部能力常驻；下方 on-demand / disabled 为按 server → 工具名分级的例外。',
+                `# 生效：tools 常驻 ${count(toolRows, 'resident')} · 按需 ${count(toolRows, 'on-demand')} · 禁用 ${count(toolRows, 'disabled')}；` +
+                    `skills 常驻 ${count(skillRows, 'resident')} · 按需 ${count(skillRows, 'on-demand')} · 禁用 ${count(skillRows, 'disabled')}`,
+                yaml.dump({
+                    metaTools: [...this.ctx.capabilityPolicy.metaTools()],
+                    tools,
+                    skills,
+                }).trimEnd(),
+            ].join('\n');
+            const catalogPath = this.ctx.capability.catalogPath?.();
+            if (catalogPath === undefined) {
+                return { policyYaml, catalogMissing: 'disabled' };
+            }
+            try {
+                const content = await readFile(catalogPath, 'utf8');
+                return { policyYaml, catalog: { path: catalogPath, content } };
+            }
+            catch (error) {
+                this.ctx.logger.warn(`capability-menu-remote: on-demand catalog read failed (${catalogPath}): ${String(error)}`);
+                return { policyYaml, catalogMissing: 'read-failed' };
+            }
+        }
     };
 })();
 export { CapabilityPolicyGateway };

package/lib/server/remote.js.map

@@ -1 +1 @@
-{"version":3,"file":"remote.js","sourceRoot":"","sources":["../../src/server/remote.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AAkB9E;;;;;;;;;;GAUG;IACU,uBAAuB;sBAAS,mBAAmB;;;;;;;;iBAAnD,uBAAwB,SAAQ,WAAmB;;;qCAQ7D,MAAM,CAAC,WAAW,CAAC;wCAMnB,MAAM,CAAC,cAAc,CAAC;uCAMtB,MAAM,CAAC,aAAa,CAAC;qCAMrB,MAAM,CAAC,WAAW,CAAC;wCAMnB,MAAM,CAAC,cAAc,CAAC;yCAMtB,MAAM,CAAC,eAAe,CAAC;YA7BxB,8KAAA,SAAS,6DAER;YAID,uLAAA,YAAY,6DAEX;YAID,oLAAA,WAAW,6DAEV;YAID,8KAAM,SAAS,6DAEd;YAID,uLAAM,YAAY,6DAEjB;YAID,0LAAM,aAAa,6DAElB;;;QAxCD,MAAM,CAAC,MAAM,GAAG,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAA;QAElD,YAAY,GAAY;YACtB,KAAK,CAAC,GAAG,EAAE,yBAAyB,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAA;YAJ/D,mDAAuB;SAKjC;QAED,wCAAwC;QAExC,SAAS;YACP,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAA;QAC9C,CAAC;QAED,+DAA+D;QAE/D,YAAY,CAAC,OAAwC;YACnD,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;QACjD,CAAC;QAED,uEAAuE;QAEvE,WAAW;YACT,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,CAAA;QACrD,CAAC;QAED,uFAAuF;QAEvF,KAAK,CAAC,SAAS,CAAC,EAAU;YACxB,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;QAC1C,CAAC;QAED,4EAA4E;QAE5E,KAAK,CAAC,YAAY,CAAC,EAAU,EAAE,OAAgB;YAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACtD,CAAC;QAED,mDAAmD;QAEnD,KAAK,CAAC,aAAa,CAAC,EAAU,EAAE,OAAe;YAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACvD,CAAC;;;SAzCU,uBAAuB;AA4CpC,gDAAgD;AAChD,MAAM,CAAC,MAAM,IAAI,GAAG,wBAAwB,CAAA;AAC5C,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAA;AACxD,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,GAAG,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAA;AACrC,CAAC"}
+{"version":3,"file":"remote.js","sourceRoot":"","sources":["../../src/server/remote.ts"],"names":[],"mappings":"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"}

package/lib/types/index.d.ts

@@ -8,10 +8,10 @@
  *   - `registry` (P0): capability catalog + `ctx.capability` service (no model tool).
  *   - `search`   (P1): registers `meta_search`.
  *   - `invoke`   (P2): registers `meta_invoke`.
- *   - `policy`   (P3): Exposed/Progressive/Blocked projection policy + `ctx.capabilityPolicy`.
+ *   - `policy`   (P3): Resident/On-demand/Disabled projection policy + `ctx.capabilityPolicy`.
  * - the package root entry (`name` + `apply` below): mounts the Typert gateway
  *   that exposes `ctx.capabilityPolicy` to the browser as the `capabilityPolicy`
- *   remote namespace — the data source of the 能力菜单 settings tab.
+ *   remote namespace — the data source of the 能力管理 settings tab.
  * - a browser bundle via the `./client` subpath (`src/client`), discovered by
  *   `@deepseek-ai/dsh-client-modules` from this package's `dsh.client`
  *   declaration and served as `/plugins/<id>/client.js`.

package/lib/types/invoke.d.ts

@@ -59,22 +59,16 @@ export type MetaInvokeResult = {
 /**
  * Register the `meta_invoke` tool.
  *
- * Dispatch is by `capability.kind`, not by id prefix (the id-prefix check is
- * kept only as a defensive guard alongside the kind check).
+ * Dispatch is by the explicit `kind` argument (no id-prefix parsing).
  *
- * - Tools (`kind: 'tool'`, id `mcp__...`): forwards to the underlying server
- *   call via the official `ctx.tools.execute` pipeline, preserving
- *   `agent`/`signal`/parent lineage. `forwardMode: 'resolve'` instead returns
- *   the target schema so the model can call the tool directly.
- * - Skills (`kind: 'skill'`, id `skill:<name>`): loads the full skill
+ * - Tools (`kind: 'tool'`, e.g. `mcp__gongfeng__create_issue` or a harness-native
+ *   tool such as `bash`): forwards to the underlying tool call via the official
+ *   `ctx.tools.execute` pipeline, preserving `agent`/`signal`/parent lineage.
+ *   `forwardMode: 'resolve'` instead returns the target schema so the model can
+ *   call the tool directly.
+ * - Skills (`kind: 'skill'`, id is the bare skill name): loads the full skill
  *   instructions and returns them as `<skill_content>` — no args, no script
  *   execution (matches the existing `skill` tool semantics).
  */
 export declare function apply(ctx: Context, config?: Config): void;
-/**
- * Strip leading YAML frontmatter (`---\n...\n---`) from a raw SKILL.md body,
- * returning the remaining markdown. Falls back to the raw text when no
- * frontmatter delimiter is present.
- */
-export declare function stripFrontmatter(markdown: string): string;
 //# sourceMappingURL=invoke.d.ts.map

package/lib/types/invoke.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/invoke.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGxD,OAAO,EAA8D,KAAK,iBAAiB,EAAoB,MAAM,wBAAwB,CAAA;AAG7I,eAAO,MAAM,IAAI,2BAA2B,CAAA;AAC5C,eAAO,MAAM,MAAM,UAAoC,CAAA;AAEvD,0CAA0C;AAC1C,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,CAAA;AAElD,gDAAgD;AAChD,MAAM,WAAW,MAAM;IACrB,sIAAsI;IACtI,WAAW,CAAC,EAAE,eAAe,CAAA;CAC9B;AAED,mDAAmD;AACnD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAE3B,CAAA;AAEF,kCAAkC;AAClC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAA;CACjC;AAED,sEAAsE;AACtE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAA;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,oEAAoE;AACpE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAC7B;AAED,sCAAsC;AACtC,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAClE;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GACtE;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,uBAAuB,CAAA;CAAE,CAAA;AAE9E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW,GAAG,IAAI,CAuQ7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzD"}
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/invoke.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAIxD,OAAO,EAAwC,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAGrG,eAAO,MAAM,IAAI,2BAA2B,CAAA;AAC5C,eAAO,MAAM,MAAM,UAAoC,CAAA;AAEvD,0CAA0C;AAC1C,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,CAAA;AAElD,gDAAgD;AAChD,MAAM,WAAW,MAAM;IACrB,sIAAsI;IACtI,WAAW,CAAC,EAAE,eAAe,CAAA;CAC9B;AAED,mDAAmD;AACnD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAE3B,CAAA;AAEF,kCAAkC;AAClC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAA;CACjC;AAED,sEAAsE;AACtE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAA;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,oEAAoE;AACpE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAC7B;AAED,sCAAsC;AACtC,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAClE;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GACtE;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,uBAAuB,CAAA;CAAE,CAAA;AAE9E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW,GAAG,IAAI,CAwP7D"}

package/lib/types/policy.d.ts

@@ -1,5 +1,5 @@
 /**
- * Exposed / Progressive / Blocked capability projection policy for the DeepSeek
+ * Resident / On-demand / Disabled capability projection policy for the DeepSeek
  * Harness.
  *
  * @module @daweifu/capability-menu (policy plugin)
@@ -11,19 +11,19 @@ import { type CapabilityKind } from './registry.ts';
 /**
  * Canonical policy classes, mirroring the registry's `CapabilityKind`.
  *
- * - `exposed`: the capability is on the dsh-native exposure surface — tools in
+ * - `resident`: the capability is on the dsh-native exposure surface — tools in
  *   `assembly.tools` (the request `tools` payload), skills in the
  *   `<available_skills>` catalog — so the model can call/load it single-hop.
- * - `progressive`: absent from the native surface but discoverable in the
+ * - `on-demand`: absent from the native surface but discoverable in the
  *   persistent meta registry; the model reaches it via `meta_search` then
  *   `meta_invoke` (catalog-resident, load/execute on demand).
- * - `blocked`: neither exposed nor discoverable nor executable.
+ * - `disabled`: neither resident nor discoverable nor executable.
  */
-export type CapabilityClass = 'exposed' | 'progressive' | 'blocked';
+export type CapabilityClass = 'resident' | 'on-demand' | 'disabled';
 /**
  * A single classify rule: an exact name or a `*`-glob pattern.
- * A pattern matches a capability id (`mcp__<server>__<raw>` / `skill:<name>`)
- * or a server name (`server:<name>`).
+ * A pattern matches a capability id (`mcp__<server>__<raw>`, a native tool
+ * name, or a bare skill name) or a server name (`server:<name>`).
  */
 export interface PolicyRule {
     /** Whether the rule is a literal exact name (`*` free) or a glob pattern. */
@@ -36,39 +36,57 @@ export interface PolicyRule {
     readonly target: 'id' | 'server';
 }
 /**
- * Per-kind explicit configuration. `exposed`/`progressive`/`blocked` are
+ * Per-kind explicit configuration. `resident`/`on-demand`/`disabled` are
  * ordered lists of exact-name / glob rules. Empty lists mean "nothing
- * explicitly classified", so the default (`exposed`) applies.
+ * explicitly classified", so the default (`resident`) applies.
  */
 export interface CapabilitySetConfig {
-    /** Explicitly-Exposed rule list (exact name or glob). */
+    /** Explicitly-Resident rule list (exact name or glob). */
+    resident?: string[];
+    /** Explicitly-On-demand rule list (exact name or glob). */
+    'on-demand'?: string[];
+    /** Explicitly-Disabled rule list (exact name or glob); wins over everything. */
+    disabled?: string[];
+    /**
+     * @deprecated pre-rename alias of `disabled`; accepted and mapped so legacy
+     * profiles written with the `blocked` key keep working without an on-disk
+     * rewrite.
+     */
+    blocked?: string[];
+    /**
+     * @deprecated pre-rename alias of `resident`; accepted and mapped so legacy
+     * profiles keep working without an on-disk rewrite.
+     */
     exposed?: string[];
-    /** Explicitly-Progressive rule list (exact name or glob). */
+    /**
+     * @deprecated pre-rename alias of `on-demand`; accepted and mapped so legacy
+     * profiles keep working without an on-disk rewrite.
+     */
     progressive?: string[];
-    /** Explicitly-Blocked rule list (exact name or glob); wins over everything. */
-    blocked?: string[];
 }
-/** Exposed / Progressive / Blocked projection policy configuration. */
+/** Resident / On-demand / Disabled projection policy configuration. */
 export interface Config {
-    /** Tool classification: `tools.exposed` / `tools.progressive` / `tools.blocked`. */
+    /** Tool classification: `tools.resident` / `tools.on-demand` / `tools.disabled`. */
     tools?: CapabilitySetConfig;
-    /** Skill classification: `skills.exposed` / `skills.progressive` / `skills.blocked`. */
+    /** Skill classification: `skills.resident` / `skills.on-demand` / `skills.disabled`. */
     skills?: CapabilitySetConfig;
     /**
-     * Tool names that are ALWAYS kept exposed and can never be classified
-     * Progressive or Blocked. Default `[meta_search, meta_invoke]`.
+     * Tool names that are ALWAYS kept resident and can never be classified
+     * On-demand or Disabled. Default `[meta_search, meta_invoke]`.
      */
     metaTools?: string[];
-    /**
-     * Optional path to a Progressive-skill catalog YAML (name + description +
-     * path). Consumed by the registry as an additional skill index source (see
-     * `@daweifu/capability-menu-registry` `progressiveSkillCatalog`).
-     */
-    progressiveSkillCatalog?: string;
 }
 /** Validate and default the policy configuration. */
 export declare const Config: z<Config>;
 export declare const DEFAULT_META_TOOLS: readonly ["meta_search", "meta_invoke"];
+/**
+ * Map a legacy rule set (old keys `exposed`/`progressive`/`blocked`) onto the
+ * current key names (`resident`/`on-demand`/`disabled`), so already-deployed
+ * `cordis.patch.yml` profiles keep working without an on-disk rewrite. New
+ * keys win when they carry rules; a legacy key fills in when the matching new
+ * list is empty.
+ */
+export declare function normalizeSetConfig(set: CapabilitySetConfig | undefined): CapabilitySetConfig | undefined;
 /**
  * Convert a user-facing rule string into a normalized {@link PolicyRule}.
  * - `server:<name>` → server-targeted rule (`target: 'server'`).
@@ -81,17 +99,17 @@ export declare function parseRule(rule: string): PolicyRule;
 export declare function compileGlob(pattern: string): RegExp;
 /** A compiled rule set for one capability kind. */
 export interface CompiledCapabilityRules {
-    readonly exposed: readonly PolicyRule[];
-    readonly progressive: readonly PolicyRule[];
-    readonly blocked: readonly PolicyRule[];
+    readonly resident: readonly PolicyRule[];
+    readonly onDemand: readonly PolicyRule[];
+    readonly disabled: readonly PolicyRule[];
 }
 /** Compile a {@link CapabilitySetConfig} into fast-matchable rules. */
 export declare function compileSet(set?: CapabilitySetConfig): CompiledCapabilityRules;
 /** Candidate fields a rule is matched against. */
 export interface MatchTarget {
-    /** Full capability id: `mcp__<server>__<raw>` or `skill:<name>`. */
+    /** Capability id: `mcp__<server>__<raw>`, a native tool name, or a bare skill name. */
     readonly id: string;
-    /** Bare model-facing name (tool name or skill name without `skill:` prefix). */
+    /** Model-facing name (for skills it equals the id; for MCP tools the public `mcp__...` name). */
     readonly name: string;
     /** Server name for tools; undefined for skills. */
     readonly server?: string;
@@ -102,9 +120,13 @@ export interface MatchTarget {
 }
 /**
  * Classify a capability against compiled rules. Priority (hit stops the walk):
- * blocked-exact > blocked-wildcard > exposed-exact > exposed-wildcard >
- * progressive-exact > progressive-wildcard > default (exposed). `blocked`
- * is a control decision, so it beats an explicit `exposed` rule.
+ * disabled-exact > disabled-wildcard > resident-exact > on-demand-exact >
+ * resident-wildcard > on-demand-wildcard > default (resident). `disabled` is a
+ * control decision, so it beats an explicit `resident` rule. Within
+ * resident/on-demand an exact name beats a wildcard, so the management UI can
+ * pin a single capability to a class even when a broader wildcard rule says
+ * otherwise (e.g. `tools.resident: ['mcp__gongfeng__*']` must not silently win
+ * over an explicit per-tool `on-demand` rule).
  */
 export declare function classify(compiled: CompiledCapabilityRules, target: MatchTarget, metaTools?: ReadonlySet<string> | readonly string[]): CapabilityClass;
 /**
@@ -117,12 +139,14 @@ export interface CapabilityClassification {
     readonly kind: CapabilityKind;
     /** Model-facing name (tool name or skill bare name). */
     readonly name: string;
-    /** MCP server for tools; undefined for skills. */
+    /** Server namespace for tools (`built-in` for harness-native tools); undefined for skills. */
     readonly server?: string;
+    /** Skill source root label, present only for skills. */
+    readonly source?: string;
     readonly class: CapabilityClass;
     /** Human-friendly display label for the classification. */
     readonly classLabel: string;
-    /** True when this capability is a mandatory meta tool (always Exposed). */
+    /** True when this capability is a mandatory meta tool (always Resident). */
     readonly mandatory: boolean;
 }
 /**
@@ -133,31 +157,30 @@ export interface CapabilityPolicyService {
     classifyTool(name: string): CapabilityClass;
     /** Classify a skill by its bare name. */
     classifySkill(name: string): CapabilityClass;
-    /** True when a tool is Exposed (or a mandatory meta tool). */
-    isExposedTool(name: string): boolean;
-    /** True when a skill is Exposed. */
-    isExposedSkill(name: string): boolean;
-    /** True when a tool is Progressive. */
-    isProgressiveTool(name: string): boolean;
-    /** True when a skill is Progressive. */
-    isProgressiveSkill(name: string): boolean;
-    /** True when a tool is Blocked. */
-    isBlockedTool(name: string): boolean;
-    /** True when a skill is Blocked. */
-    isBlockedSkill(name: string): boolean;
-    /** True when a capability id (`mcp__...` / `skill:...`) is Blocked. */
-    isBlockedCapability(id: string): boolean;
-    /** Tool names that are always kept Exposed. */
+    /** True when a tool is Resident (or a mandatory meta tool). */
+    isResidentTool(name: string): boolean;
+    /** True when a skill is Resident. */
+    isResidentSkill(name: string): boolean;
+    /** True when a tool is Disabled. */
+    isDisabledTool(name: string): boolean;
+    /** True when a skill is Disabled. */
+    isDisabledSkill(name: string): boolean;
+    /**
+     * True when a capability (by id and `kind`) is Disabled. `kind` disambiguates
+     * a bare name shared by a tool and a skill.
+     */
+    isDisabledCapability(id: string, kind?: CapabilityKind): boolean;
+    /** Tool names that are always kept Resident. */
     metaTools(): readonly string[];
-    /** Resolve a capability's id (e.g. `skill:<name>`) to a class. */
-    classifyCapability(id: string): CapabilityClass;
-    /** Rules exposed for the registry/other consumers. */
+    /** Resolve a capability's id to a class; pass `kind` to disambiguate a bare name. */
+    classifyCapability(id: string, kind?: CapabilityKind): CapabilityClass;
+    /** Rules resident for the registry/other consumers. */
     toolRules(): CompiledCapabilityRules;
     skillRules(): CompiledCapabilityRules;
     /** Current (resolved) policy config. */
     getConfig(): Config;
     /** Replace a subset of the policy config and recompile rules immediately. */
-    updateConfig(partial: Partial<Config>): void;
+    updateConfig(partial: Partial<Config>): Promise<void>;
     /**
      * Classify every capability currently indexed by `ctx.capability` (the
      * registry sibling). Returns an empty array when the registry is not mounted.
@@ -170,12 +193,12 @@ declare module '@deepseek-ai/cordis' {
     }
 }
 /**
- * Build the projection listener for one assembly: keep only Exposed tools plus
+ * Build the projection listener for one assembly: keep only Resident tools plus
  * the mandatory meta tools.
  */
 export declare function projectAssemblyTools(assembly: PromptAssembly, service: CapabilityPolicyService): PromptAssembly;
 /** Build the policy plugin. */
 export declare const name = "capability-menu-policy";
 export declare const inject: string[];
-export declare function apply(ctx: Context, config?: Config): void;
+export declare function apply(ctx: Context, config?: Config): Promise<void>;
 //# sourceMappingURL=policy.d.ts.map

package/lib/types/policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/policy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/policy.ts"],"names":[],"mappings":"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"}

package/lib/types/registry.d.ts

@@ -9,7 +9,8 @@ import type { ScopeKey } from '@deepseek-ai/dsh-scope';
 import type { JsonSchemaNode } from '@deepseek-ai/dsh-tools';
 /**
  * Kinds of capability the catalog can hold.
- * - `tool`:   action capability — executes a concrete action (an MCP tool).
+ * - `tool`:   action capability — executes a concrete action (an MCP tool or a
+ *   harness-native tool cataloged under the reserved `built-in` server).
  * - `skill`:  action capability — loads the method/instructions for a task.
  */
 export type CapabilityKind = 'tool' | 'skill';
@@ -17,21 +18,41 @@ export type CapabilityKind = 'tool' | 'skill';
  * Stable invocation actions a capability can declare. Each kind maps to one
  * canonical action; a new kind only deserves a new value here when it
  * introduces a new action (not a new flavor of an existing one).
- * `execute` = run the concrete action (an MCP tool, via `ctx.tools.execute`);
+ * `execute` = run the concrete action (a tool — MCP or native — via `ctx.tools.execute`);
  * `load`    = load the method/instructions (a skill).
  */
 export type CapabilityAction = 'execute' | 'load';
-/** Stable identifier prefixes: MCP tools keep `mcp__...`, skills use `skill:<name>`. */
-export declare const SKILL_ID_PREFIX = "skill:";
+/**
+ * Tool id prefixes are part of the REAL registered tool name: MCP tools are
+ * registered as `mcp__<server>__<raw>` by the harness MCP client and natives
+ * keep their bare name (`bash`/`read`/…), so tool records are keyed by that
+ * name. Skills have no name-level namespace: a skill's id IS its bare name and
+ * `kind` disambiguates it from a same-named tool.
+ */
 export declare const MCP_ID_PREFIX = "mcp__";
+/**
+ * Reserved pseudo-server that groups harness-native (non-MCP) tools in the
+ * management surface. Native tools (bash/read/write/…) are cataloged like MCP
+ * tools — same `server` dimension — so the 能力管理 can group them, classify
+ * them Resident/On-demand/Disabled, and `meta_invoke` can dispatch them.
+ */
+export declare const BUILT_IN_SERVER = "built-in";
+/**
+ * Tool names that never enter the capability catalog: this plugin's own
+ * control plane (`meta_search`/`meta_invoke`, always Resident) and the
+ * reserved Code Mode presentation transport (`run_code`).
+ */
+export declare const CATALOG_EXCLUDED_TOOLS: ReadonlySet<string>;
 /** Capability-stable origin metadata used by search filters and detail views. */
 export interface CapabilityOrigin {
-    /** Human/namespace label, e.g. `gongfeng` or `filesystem`. */
+    /** Human/namespace label: an MCP server name, the reserved `built-in` for native tools, or a skill provider. */
     readonly provider: string;
-    /** MCP server name, present only for `kind: 'tool'`. */
+    /** Server namespace, present only for `kind: 'tool'` (`built-in` for native tools). */
     readonly serverName?: string;
     /** Local skill path, present only for `kind: 'skill'`. */
     readonly path?: string;
+    /** Skill source root label (`project-dsh`/`user-agents`/…), present only for skills. */
+    readonly source?: string;
 }
 /** Objective and subjective usage statistics, written back from `tools/result`. */
 export interface CapabilityStats {
@@ -43,7 +64,7 @@ export interface CapabilityStats {
 }
 /** One indexed capability. */
 export interface CapabilityRecord {
-    /** Stable identifier: `mcp__<server>__<raw>` or `skill:<name>`. */
+    /** Stable identifier: `mcp__<server>__<raw>`, a native tool name, or a bare skill name. */
     readonly id: string;
     readonly kind: CapabilityKind;
     /** The canonical invocation action(s) this capability exposes. */
@@ -72,6 +93,8 @@ export interface CapabilitySummary {
     readonly name: string;
     readonly summary: string;
     readonly server?: string;
+    /** Skill source root label, present only for `kind: 'skill'`. */
+    readonly source?: string;
     readonly tags: readonly string[];
     readonly success_rate?: number;
     readonly uses: number;
@@ -99,7 +122,7 @@ export interface MetaSearchOptions {
     readonly maxResults?: number;
     /**
      * Viewing scope. Retained for caller ergonomics and optional authorization
-     * checks, but the policy does NOT use it to filter visibility — Progressive
+     * checks, but the policy does NOT use it to filter visibility — On-demand
      * capabilities must remain searchable regardless of the caller's projection.
      */
     readonly scope?: ScopeKey | undefined;
@@ -125,10 +148,17 @@ export interface SkillDirEntry {
 export interface CapabilityService {
     /** Enumerate the current catalog (optionally filtered). */
     search(options?: MetaSearchOptions): CapabilitySummary[];
-    /** Resolve one record by id, or undefined. */
-    get(id: string): CapabilityRecord | undefined;
-    /** Resolve one record's full detail (schema, output; skill body optional). */
-    getDetail(id: string, context?: MetaLookupContext): Promise<CapabilityDetail | undefined>;
+    /**
+     * Resolve one record by id, or undefined. Pass `kind` when the caller knows
+     * it (tools and skills may share a bare name, e.g. a skill named `bash`);
+     * without `kind` a same-name tool/skill pair resolves to undefined.
+     */
+    get(id: string, kind?: CapabilityKind): CapabilityRecord | undefined;
+    /**
+     * Resolve one record's full detail (schema, output; skill body optional).
+     * `kind` has the same disambiguation semantics as {@link get}.
+     */
+    getDetail(id: string, kind?: CapabilityKind, context?: MetaLookupContext): Promise<CapabilityDetail | undefined>;
     /**
      * List a skill's directory children (one level deep). The directory is
      * resolved from the skill's own provider path, never from caller input;
@@ -144,11 +174,23 @@ export interface CapabilityService {
     readSkillFile(id: string, relPath: string): Promise<string | undefined>;
     /** Return the current number of indexed capabilities. */
     size(): number;
+    /**
+     * Absolute path of the on-demand capability catalog YAML, when emission is
+     * enabled. The model can browse this file with grep/read instead of only
+     * reaching the catalog through `meta_search`.
+     */
+    catalogPath(): string | undefined;
+    /**
+     * Number of On-demand capabilities in the latest catalog emission. Used by
+     * the policy's assemble hook to skip the catalog pointer when there is
+     * nothing On-demand to browse.
+     */
+    onDemandCount(): number;
     /**
      * Rebuild the catalog from the current tool/skill registries; resolves when
      * done. In production the registry rebuilds automatically on `tools/change`
      * / `skills/change`; this public handle is for tests and external orchestrators
-     * that want to force a rebuild (e.g. after a `progressiveSkillCatalog` change).
+     * that want to force a rebuild.
      */
     refresh(): Promise<void>;
 }
@@ -168,13 +210,12 @@ export interface Config {
     /** Experience-weighting intensity for ranking (0 disables, default 0.1). */
     weighting?: number;
     /**
-     * Optional path to a Progressive-skill catalog YAML (see §7.2). Each entry
-     * `{ name, description, whenToUse?, path? }` is indexed as a `skill`
-     * CapabilityRecord so `meta_search(kind=skill)` can find Progressive skills
-     * that are not otherwise registered in the session skill registry. The full
-     * SKILL.md is loaded on demand by `meta_invoke` (see the invoke package).
+     * Optional path for the on-demand capability catalog emitted as a YAML file
+     * for model-side grep/read browsing. Defaults to
+     * `~/.dsh/capability-catalog.yaml`; set to an empty string to disable
+     * emission. Disabled capabilities are never written.
      */
-    progressiveSkillCatalog?: string;
+    catalogFile?: string;
 }
 /** Validate and default the registry configuration. */
 export declare const Config: z<Config>;
@@ -184,8 +225,4 @@ export declare const inject: string[];
 export declare function apply(ctx: Context, config?: Config): void;
 /** Derive the server namespace from an `mcp__<server>__<raw>` name. */
 export declare function serverNameOf(publicName: string): string;
-/** Build the stable skill identifier `skill:<name>`. */
-export declare function skillId(name: string): string;
-/** Strip the `skill:` prefix from a capability id. */
-export declare function skillNameOf(id: string): string;
 //# sourceMappingURL=registry.d.ts.map