@ytinnovation/harness-core 0.0.0

package/README.md

@@ -0,0 +1,17 @@
+# @ytinnovation/harness-core
+
+Harness CLI 的核心运行时包，包含命令路由、初始化、资产、MCP、知识库、telemetry 与 dashboard 托管能力。
+
+通常不需要直接安装该包。请安装 CLI：
+
+```bash
+npm install -g @ytinnovation/harness-cli
+```
+
+## Dashboard 静态资源
+
+发布准备脚本会将 `apps/harness-dashboard/dist` 复制到本包的 `dist/dashboard-assets`。因此安装 `@ytinnovation/harness-cli` 后可以直接运行：
+
+```bash
+harness dashboard serve --port 4242
+```

package/dist/assets/fetch-published-by-name.d.ts

@@ -0,0 +1,16 @@
+import type { EnterpriseAssetClient } from '../cloud/enterprise-asset-client.js';
+import type { HarnessServiceAssetType } from '../cloud/enterprise-asset-types.js';
+export type PublishedAssetByName = {
+    readonly assetId: string;
+    readonly type: HarnessServiceAssetType;
+    readonly name: string;
+    readonly version: string;
+    readonly description: string | null;
+    readonly content: string;
+};
+export declare function fetchPublishedAssetByName(args: {
+    readonly client: EnterpriseAssetClient;
+    readonly type: HarnessServiceAssetType;
+    readonly name: string;
+}): Promise<PublishedAssetByName>;
+//# sourceMappingURL=fetch-published-by-name.d.ts.map

package/dist/assets/fetch-published-by-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-published-by-name.d.ts","sourceRoot":"","sources":["../../src/assets/fetch-published-by-name.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAGlF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2ChC"}

package/dist/assets/fetch-published-by-name.js

@@ -0,0 +1,40 @@
+import { HarnessError } from '../contracts/errors.js';
+import { resolvePublishedAssetBody } from './published-content.js';
+export async function fetchPublishedAssetByName(args) {
+    const name = args.name.trim();
+    if (!name) {
+        throw new HarnessError('ASSET_NOT_FOUND', 'Asset name is required.');
+    }
+    const candidates = await args.client.searchPublished({
+        type: args.type,
+        query: name,
+        limit: 20,
+    });
+    const exactMatches = candidates.filter((item) => item.name === name);
+    if (exactMatches.length === 0) {
+        throw new HarnessError('ASSET_NOT_FOUND', `Published ${args.type} "${name}" was not found.`);
+    }
+    if (exactMatches.length > 1) {
+        throw new HarnessError('ASSET_AMBIGUOUS', `Multiple published ${args.type} assets named "${name}" were found; refine by scope or use asset id.`);
+    }
+    const asset = exactMatches[0];
+    const detail = await args.client.getAssetDetail(asset.id);
+    const version = detail?.latestPublished?.version ?? asset.latestPublished?.version;
+    if (!version) {
+        throw new HarnessError('ASSET_NOT_FOUND', `Published ${args.type} "${name}" has no published version.`);
+    }
+    const published = await args.client.getPublishedVersion(asset.id, version);
+    if (!published?.content) {
+        throw new HarnessError('ASSET_NOT_FOUND', `Published ${args.type} "${name}" has no published body.`);
+    }
+    const resolved = resolvePublishedAssetBody(published.content, { assetName: asset.name });
+    return {
+        assetId: asset.id,
+        type: args.type,
+        name: asset.name,
+        version,
+        description: detail?.description ?? asset.description ?? null,
+        content: resolved.content,
+    };
+}
+//# sourceMappingURL=fetch-published-by-name.js.map

package/dist/assets/fetch-published-by-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-published-by-name.js","sourceRoot":"","sources":["../../src/assets/fetch-published-by-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAWnE,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,IAI/C;IACC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,yBAAyB,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;QACnD,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,EAAE;KACV,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACrE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,aAAa,IAAI,CAAC,IAAI,KAAK,IAAI,kBAAkB,CAAC,CAAC;IAC/F,CAAC;IACD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,YAAY,CACpB,iBAAiB,EACjB,sBAAsB,IAAI,CAAC,IAAI,kBAAkB,IAAI,gDAAgD,CACtG,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,EAAE,eAAe,EAAE,OAAO,IAAI,KAAK,CAAC,eAAe,EAAE,OAAO,CAAC;IACnF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,aAAa,IAAI,CAAC,IAAI,KAAK,IAAI,6BAA6B,CAAC,CAAC;IAC1G,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC3E,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,aAAa,IAAI,CAAC,IAAI,KAAK,IAAI,0BAA0B,CAAC,CAAC;IACvG,CAAC;IAED,MAAM,QAAQ,GAAG,yBAAyB,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACzF,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,EAAE;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO;QACP,WAAW,EAAE,MAAM,EAAE,WAAW,IAAI,KAAK,CAAC,WAAW,IAAI,IAAI;QAC7D,OAAO,EAAE,QAAQ,CAAC,OAAO;KAC1B,CAAC;AACJ,CAAC"}

package/dist/assets/install-content.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 安装时向 Markdown/MDC 正文注入最小 manifest（仅 `id`）。
+ * 源仓库 master 分支文件不含此头；元数据写入 `.cursor/harness-assets.json`。
+ */
+export declare function injectInstalledAssetIdHeader(content: string, assetId: string): string;
+export declare function isMarkdownLikeAssetPath(targetPath: string): boolean;
+//# sourceMappingURL=install-content.d.ts.map

package/dist/assets/install-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-content.d.ts","sourceRoot":"","sources":["../../src/assets/install-content.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAiBrF;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEnE"}

package/dist/assets/install-content.js

@@ -0,0 +1,24 @@
+/**
+ * 安装时向 Markdown/MDC 正文注入最小 manifest（仅 `id`）。
+ * 源仓库 master 分支文件不含此头；元数据写入 `.cursor/harness-assets.json`。
+ */
+export function injectInstalledAssetIdHeader(content, assetId) {
+    const normalizedId = assetId.trim();
+    if (!normalizedId) {
+        return content;
+    }
+    const trimmed = content.trimStart();
+    const frontmatterMatch = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(trimmed);
+    if (frontmatterMatch) {
+        const existingLines = (frontmatterMatch[1] ?? '')
+            .split(/\r?\n/)
+            .filter((line) => !line.trimStart().startsWith('id:'));
+        const body = trimmed.slice(frontmatterMatch[0].length);
+        return ['---', `id: ${normalizedId}`, ...existingLines, '---', '', body.trimStart()].join('\n');
+    }
+    return `---\nid: ${normalizedId}\n---\n\n${trimmed}`;
+}
+export function isMarkdownLikeAssetPath(targetPath) {
+    return /\.(?:md|mdc|markdown)$/i.test(targetPath);
+}
+//# sourceMappingURL=install-content.js.map

package/dist/assets/install-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-content.js","sourceRoot":"","sources":["../../src/assets/install-content.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAe,EAAE,OAAe;IAC3E,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IACpC,MAAM,gBAAgB,GAAG,mCAAmC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3E,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,aAAa,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aAC9C,KAAK,CAAC,OAAO,CAAC;aACd,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACvD,OAAO,CAAC,KAAK,EAAE,OAAO,YAAY,EAAE,EAAE,GAAG,aAAa,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClG,CAAC;IAED,OAAO,YAAY,YAAY,YAAY,OAAO,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,UAAkB;IACxD,OAAO,yBAAyB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACpD,CAAC"}

package/dist/assets/install-from.d.ts

@@ -0,0 +1,6 @@
+/** 用户通过 `harness skill install` 等手动路径安装的资产来源标识（写入 manifest，更新时不可变）。 */
+export declare const MANUAL_INSTALL_FROM: "\u7528\u6237\u624B\u52A8\u5B89\u88C5";
+export type AssetInstallFrom = typeof MANUAL_INSTALL_FROM | (string & {});
+export declare function isManualInstallFrom(installFrom: string | undefined): boolean;
+export declare function resolveConfigPackInstallFrom(packId: string): string;
+//# sourceMappingURL=install-from.d.ts.map

package/dist/assets/install-from.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-from.d.ts","sourceRoot":"","sources":["../../src/assets/install-from.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,EAAG,sCAAiB,CAAC;AAErD,MAAM,MAAM,gBAAgB,GAAG,OAAO,mBAAmB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE1E,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE5E;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMnE"}

package/dist/assets/install-from.js

@@ -0,0 +1,13 @@
+/** 用户通过 `harness skill install` 等手动路径安装的资产来源标识（写入 manifest，更新时不可变）。 */
+export const MANUAL_INSTALL_FROM = '用户手动安装';
+export function isManualInstallFrom(installFrom) {
+    return installFrom === MANUAL_INSTALL_FROM;
+}
+export function resolveConfigPackInstallFrom(packId) {
+    const trimmed = packId.trim();
+    if (!trimmed) {
+        throw new Error('Config pack id is required for installFrom.');
+    }
+    return trimmed;
+}
+//# sourceMappingURL=install-from.js.map

package/dist/assets/install-from.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-from.js","sourceRoot":"","sources":["../../src/assets/install-from.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAiB,CAAC;AAIrD,MAAM,UAAU,mBAAmB,CAAC,WAA+B;IACjE,OAAO,WAAW,KAAK,mBAAmB,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAc;IACzD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/assets/install.d.ts

@@ -0,0 +1,36 @@
+import { EnterpriseAssetClient } from '../cloud/enterprise-asset-client.js';
+export type InstallableAssetType = 'skill' | 'rule' | 'spec' | 'mcp-config';
+export type InstallTarget = 'cursor' | 'agents';
+export interface InstalledAssetResult {
+    assetType: InstallableAssetType;
+    name: string;
+    version: string;
+    sourceRef: string;
+    targetPaths: string[];
+    action: 'create' | 'skip';
+}
+export declare function parseInstallTargets(args: string[]): {
+    targets: InstallTarget[];
+    rest: string[];
+};
+export declare function resolveSkillRegistryPath(args: {
+    workspaceRoot: string;
+    homeRegistryPath: string;
+    explicitRegistryPath?: string;
+    global: boolean;
+}): string;
+export declare function resolveSkillTargetDir(args: {
+    workspaceRoot: string;
+    homeDir: string;
+    installTargetDir?: string;
+    target: InstallTarget;
+    global: boolean;
+}): string;
+export declare function installPublishedAssetByName(args: {
+    assetType: InstallableAssetType;
+    name: string;
+    workspaceRoot: string;
+    targets: InstallTarget[];
+    client: EnterpriseAssetClient;
+}): Promise<InstalledAssetResult>;
+//# sourceMappingURL=install.d.ts.map

package/dist/assets/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/assets/install.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAM5E,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;AAC5E,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEhD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,oBAAoB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;CAC3B;AAiBD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAmChG;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,MAAM,CAQT;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,MAAM,CAUT;AA2ED,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,SAAS,EAAE,oBAAoB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,MAAM,EAAE,qBAAqB,CAAC;CAC/B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA4DhC"}

package/dist/assets/install.js

@@ -0,0 +1,199 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, isAbsolute, join } from 'node:path';
+import { HarnessError } from '../contracts/errors.js';
+import { EnterpriseAssetClient } from '../cloud/enterprise-asset-client.js';
+import { mergeCursorMcpConfigContent, parseCursorMcpConfigContent } from './mcp-config-format.js';
+import { resolvePublishedAssetBody } from './published-content.js';
+import { resolveProjectManifestPath } from './project-manifest.js';
+const SERVICE_TYPE_BY_ASSET_TYPE = {
+    skill: 'skill',
+    rule: 'rule',
+    spec: 'spec_template',
+    'mcp-config': 'mcp_config',
+};
+function sanitizeName(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+export function parseInstallTargets(args) {
+    const targets = new Set(['cursor']);
+    const rest = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (!arg) {
+            continue;
+        }
+        if (arg === '--target') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('--')) {
+                throw new HarnessError('ASSET_INSTALL_INVALID_ARGS', 'Missing value for --target.');
+            }
+            for (const item of value.split(',')) {
+                const normalized = item.trim();
+                if (normalized === 'cursor' || normalized === '.cursor') {
+                    targets.add('cursor');
+                }
+                else if (normalized === 'agents' || normalized === '.agents') {
+                    targets.add('agents');
+                }
+                else {
+                    throw new HarnessError('ASSET_INSTALL_INVALID_ARGS', `Unknown install target: ${item}`);
+                }
+            }
+            index += 1;
+            continue;
+        }
+        if (arg === '--agents') {
+            targets.add('agents');
+            continue;
+        }
+        rest.push(arg);
+    }
+    return { targets: [...targets], rest };
+}
+export function resolveSkillRegistryPath(args) {
+    if (args.explicitRegistryPath) {
+        return args.explicitRegistryPath;
+    }
+    if (args.global) {
+        return args.homeRegistryPath;
+    }
+    return resolveProjectManifestPath(args.workspaceRoot);
+}
+export function resolveSkillTargetDir(args) {
+    if (args.installTargetDir) {
+        return isAbsolute(args.installTargetDir)
+            ? args.installTargetDir
+            : join(args.workspaceRoot, args.installTargetDir);
+    }
+    if (args.global) {
+        return join(args.homeDir, '.agents', 'skills');
+    }
+    return join(args.workspaceRoot, args.target === 'agents' ? '.agents' : '.cursor', 'skills');
+}
+function targetRelativePath(assetType, name, target) {
+    const safeName = sanitizeName(name) || 'asset';
+    if (assetType === 'skill') {
+        return join(target === 'agents' ? '.agents' : '.cursor', 'skills', safeName, 'SKILL.md');
+    }
+    if (assetType === 'rule') {
+        return join(target === 'agents' ? '.agents' : '.cursor', 'rules', `${safeName}.mdc`);
+    }
+    if (assetType === 'spec') {
+        return join(target === 'agents' ? '.agents' : '.cursor', 'specs', `${safeName}.md`);
+    }
+    if (assetType === 'mcp-config') {
+        return join(target === 'agents' ? '.agents' : '.cursor', 'mcp.json');
+    }
+    return join(target === 'agents' ? '.agents' : '.cursor', 'assets', `${safeName}.json`);
+}
+async function readFileOrNull(targetPath) {
+    try {
+        return await readFile(targetPath, 'utf8');
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT') {
+            throw error;
+        }
+        return null;
+    }
+}
+async function writeIfChanged(targetPath, content) {
+    try {
+        const existing = await readFile(targetPath, 'utf8');
+        if (existing === content) {
+            return 'skip';
+        }
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT') {
+            throw error;
+        }
+    }
+    await mkdir(dirname(targetPath), { recursive: true });
+    await writeFile(targetPath, content, 'utf8');
+    return 'create';
+}
+async function installMcpConfigContent(args) {
+    const resolved = resolvePublishedAssetBody(args.content);
+    try {
+        parseCursorMcpConfigContent(resolved.content);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new HarnessError('MCP_CONFIG_INVALID', message);
+    }
+    const targetPaths = [];
+    let action = 'skip';
+    for (const target of args.targets) {
+        const targetPath = join(args.workspaceRoot, targetRelativePath('mcp-config', 'mcp', target));
+        const existing = await readFileOrNull(targetPath);
+        const merged = mergeCursorMcpConfigContent(existing, resolved.content);
+        const writeAction = await writeIfChanged(targetPath, merged);
+        targetPaths.push(targetPath);
+        if (writeAction === 'create') {
+            action = 'create';
+        }
+    }
+    return { targetPaths, action };
+}
+export async function installPublishedAssetByName(args) {
+    const name = args.name.trim();
+    if (!name) {
+        throw new HarnessError('ASSET_INSTALL_INVALID_ARGS', 'Asset name is required.');
+    }
+    const candidates = await args.client.searchPublished({
+        type: SERVICE_TYPE_BY_ASSET_TYPE[args.assetType],
+        query: name,
+    });
+    const exact = candidates.find((item) => item.name === name) ?? candidates[0];
+    if (!exact) {
+        throw new HarnessError('ASSET_NOT_FOUND', `Published ${args.assetType} "${name}" was not found.`);
+    }
+    const detail = await args.client.getAssetDetail(exact.id);
+    const version = detail?.latestPublished?.version ?? exact.latestPublished?.version;
+    if (!version) {
+        throw new HarnessError('ASSET_NOT_FOUND', `Published ${args.assetType} "${name}" has no published version.`);
+    }
+    const published = await args.client.getPublishedVersion(exact.id, version);
+    if (!published?.content) {
+        throw new HarnessError('ASSET_NOT_FOUND', `Published ${args.assetType} "${name}" has no published body.`);
+    }
+    if (args.assetType === 'mcp-config') {
+        const { targetPaths, action } = await installMcpConfigContent({
+            workspaceRoot: args.workspaceRoot,
+            targets: args.targets,
+            content: published.content,
+        });
+        return {
+            assetType: args.assetType,
+            name: exact.name,
+            version,
+            sourceRef: `harness-service://asset/${exact.id}`,
+            targetPaths,
+            action,
+        };
+    }
+    const targetPaths = [];
+    let action = 'skip';
+    for (const target of args.targets) {
+        const targetPath = join(args.workspaceRoot, targetRelativePath(args.assetType, exact.name, target));
+        const writeAction = await writeIfChanged(targetPath, published.content);
+        targetPaths.push(targetPath);
+        if (writeAction === 'create') {
+            action = 'create';
+        }
+    }
+    return {
+        assetType: args.assetType,
+        name: exact.name,
+        version,
+        sourceRef: `harness-service://asset/${exact.id}`,
+        targetPaths,
+        action,
+    };
+}
+//# sourceMappingURL=install.js.map

package/dist/assets/install.js.map

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

package/dist/assets/mcp-config-format.d.ts

@@ -0,0 +1,11 @@
+export declare class McpConfigFormatError extends Error {
+    constructor(message: string);
+}
+/** 与 Cursor `.cursor/mcp.json` 对齐：根对象含非空 `mcpServers`。 */
+export declare function parseCursorMcpConfigContent(raw: string): {
+    mcpServers: Record<string, Record<string, unknown>>;
+};
+export declare function validateCursorMcpConfigContent(raw: string): void;
+/** 将 incoming 的 mcpServers 合并进现有 `.cursor/mcp.json` 内容。 */
+export declare function mergeCursorMcpConfigContent(existingContent: string | null, incomingContent: string): string;
+//# sourceMappingURL=mcp-config-format.d.ts.map

package/dist/assets/mcp-config-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config-format.d.ts","sourceRoot":"","sources":["../../src/assets/mcp-config-format.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AA+CD,0DAA0D;AAC1D,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,CAyBhH;AAED,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED,2DAA2D;AAC3D,wBAAgB,2BAA2B,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAkC3G"}

package/dist/assets/mcp-config-format.js

@@ -0,0 +1,101 @@
+export class McpConfigFormatError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'McpConfigFormatError';
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function sortRecordKeys(record) {
+    const sortedEntries = Object.entries(record).sort(([left], [right]) => left.localeCompare(right));
+    const output = {};
+    for (const [key, value] of sortedEntries) {
+        if (isRecord(value)) {
+            output[key] = sortRecordKeys(value);
+            continue;
+        }
+        output[key] = value;
+    }
+    return output;
+}
+function validateServerConfig(serverName, value) {
+    if (!isRecord(value)) {
+        throw new McpConfigFormatError(`mcpServers.${serverName} must be an object.`);
+    }
+    if (typeof value.command !== 'string' || value.command.trim().length === 0) {
+        throw new McpConfigFormatError(`mcpServers.${serverName}.command must be a non-empty string.`);
+    }
+    if (value.args !== undefined) {
+        if (!Array.isArray(value.args) || !value.args.every((arg) => typeof arg === 'string')) {
+            throw new McpConfigFormatError(`mcpServers.${serverName}.args must be an array of strings.`);
+        }
+    }
+    if (value.cwd !== undefined && typeof value.cwd !== 'string') {
+        throw new McpConfigFormatError(`mcpServers.${serverName}.cwd must be a string.`);
+    }
+    if (value.env !== undefined) {
+        if (!isRecord(value.env) || Object.values(value.env).some((entry) => typeof entry !== 'string')) {
+            throw new McpConfigFormatError(`mcpServers.${serverName}.env must be an object of string values.`);
+        }
+    }
+}
+/** 与 Cursor `.cursor/mcp.json` 对齐：根对象含非空 `mcpServers`。 */
+export function parseCursorMcpConfigContent(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new McpConfigFormatError('MCP config must be valid JSON.');
+    }
+    if (!isRecord(parsed)) {
+        throw new McpConfigFormatError('MCP config root must be a JSON object.');
+    }
+    const mcpServers = parsed.mcpServers;
+    if (!isRecord(mcpServers) || Object.keys(mcpServers).length === 0) {
+        throw new McpConfigFormatError('MCP config must include a non-empty mcpServers object.');
+    }
+    for (const [serverName, serverConfig] of Object.entries(mcpServers)) {
+        if (serverName.trim().length === 0) {
+            throw new McpConfigFormatError('mcpServers keys must be non-empty strings.');
+        }
+        validateServerConfig(serverName, serverConfig);
+    }
+    return { mcpServers: mcpServers };
+}
+export function validateCursorMcpConfigContent(raw) {
+    parseCursorMcpConfigContent(raw);
+}
+/** 将 incoming 的 mcpServers 合并进现有 `.cursor/mcp.json` 内容。 */
+export function mergeCursorMcpConfigContent(existingContent, incomingContent) {
+    const incoming = parseCursorMcpConfigContent(incomingContent);
+    if (!existingContent) {
+        return incomingContent;
+    }
+    let existingParsed;
+    try {
+        existingParsed = JSON.parse(existingContent);
+    }
+    catch {
+        return incomingContent;
+    }
+    if (!isRecord(existingParsed)) {
+        return incomingContent;
+    }
+    const existingServersRaw = existingParsed.mcpServers;
+    const existingServers = isRecord(existingServersRaw) ? existingServersRaw : {};
+    const mergedServers = {
+        ...existingServers,
+        ...incoming.mcpServers,
+    };
+    const mergedConfig = {};
+    for (const [key, value] of Object.entries(existingParsed)) {
+        if (key !== 'mcpServers') {
+            mergedConfig[key] = value;
+        }
+    }
+    mergedConfig.mcpServers = sortRecordKeys(mergedServers);
+    return JSON.stringify(sortRecordKeys(mergedConfig), null, 2);
+}
+//# sourceMappingURL=mcp-config-format.js.map

package/dist/assets/mcp-config-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config-format.js","sourceRoot":"","sources":["../../src/assets/mcp-config-format.ts"],"names":[],"mappings":"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"}

package/dist/assets/metadata.d.ts

@@ -0,0 +1,65 @@
+export type AssetType = 'skill' | 'rule' | 'spec' | 'command' | 'mcp-config' | 'prompt';
+export type AssetReviewStatus = 'unreviewed' | 'approved' | 'rejected' | 'deprecated';
+export interface AssetMetadata {
+    assetType: AssetType;
+    name: string;
+    version: string;
+    hash: string;
+    source: string;
+    revision: string | null;
+    reviewStatus: AssetReviewStatus;
+    installedAt: string;
+    /** 企业资产 URI（`harness-service://asset/<uuid>`），供 update 解析 assetId。 */
+    sourceRef?: string;
+    description?: string;
+    entrypoint?: string;
+    tags?: string[];
+    managedBy?: string;
+}
+export interface LocalRuleMetadataRecord {
+    ruleName: string;
+    targetPath: string;
+    metadata: AssetMetadata;
+}
+export interface LocalCommandMetadataRecord {
+    commandName: string;
+    targetPath: string;
+    metadata: AssetMetadata;
+}
+export interface LocalPromptMetadataRecord {
+    promptName: string;
+    targetPath: string;
+    metadata: AssetMetadata;
+}
+export interface LocalMcpConfigMetadataRecord {
+    mcpConfigName: string;
+    targetPath: string;
+    metadata: AssetMetadata;
+}
+export interface LocalRuleMetadataStore {
+    version: 1;
+    records: LocalRuleMetadataRecord[];
+}
+export interface LocalCommandMetadataStore {
+    version: 1;
+    records: LocalCommandMetadataRecord[];
+}
+export interface LocalPromptMetadataStore {
+    version: 1;
+    records: LocalPromptMetadataRecord[];
+}
+export interface LocalMcpConfigMetadataStore {
+    version: 1;
+    records: LocalMcpConfigMetadataRecord[];
+}
+export declare function isAssetMetadata(value: unknown): value is AssetMetadata;
+export declare function assertAssetMetadata(value: unknown, context: string): asserts value is AssetMetadata;
+export declare function serializeAssetMetadata(metadata: AssetMetadata): string;
+export declare function parseAssetMetadata(serialized: string): AssetMetadata;
+export declare function serializeLocalRuleMetadataStore(store: LocalRuleMetadataStore): string;
+export declare function serializeLocalCommandMetadataStore(store: LocalCommandMetadataStore): string;
+export declare function parseLocalRuleMetadataStore(serialized: string): LocalRuleMetadataStore;
+export declare function parseLocalPromptMetadataStore(serialized: string): LocalPromptMetadataStore;
+export declare function parseLocalMcpConfigMetadataStore(serialized: string): LocalMcpConfigMetadataStore;
+export declare function parseLocalCommandMetadataStore(serialized: string): LocalCommandMetadataStore;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/assets/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/assets/metadata.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;AACxF,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;AAEtF,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,iBAAiB,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,uBAAuB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,0BAA0B,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,yBAAyB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,4BAA4B,EAAE,CAAC;CACzC;AAmBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CA0BtE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAOnG;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAGtE;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAIpE;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAgBrF;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAoB3F;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,CAyBtF;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,wBAAwB,CAyB1F;AAED,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,MAAM,GAAG,2BAA2B,CAyBhG;AAED,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,yBAAyB,CA6B5F"}