@ytinnovation/harness-core 0.0.0

package/dist/assets/metadata.js

@@ -0,0 +1,164 @@
+import { HarnessError } from '../contracts/errors.js';
+function isObject(value) {
+    return !!value && typeof value === 'object';
+}
+function isAssetReviewStatus(value) {
+    return (value === 'unreviewed' ||
+        value === 'approved' ||
+        value === 'rejected' ||
+        value === 'deprecated');
+}
+function isOptionalStringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === 'string');
+}
+export function isAssetMetadata(value) {
+    if (!isObject(value)) {
+        return false;
+    }
+    return ((value.assetType === 'skill' ||
+        value.assetType === 'rule' ||
+        value.assetType === 'spec' ||
+        value.assetType === 'command' ||
+        value.assetType === 'mcp-config' ||
+        value.assetType === 'prompt') &&
+        typeof value.name === 'string' &&
+        typeof value.version === 'string' &&
+        typeof value.hash === 'string' &&
+        value.hash.trim().length > 0 &&
+        typeof value.source === 'string' &&
+        (typeof value.revision === 'string' || value.revision === null) &&
+        isAssetReviewStatus(value.reviewStatus) &&
+        typeof value.installedAt === 'string' &&
+        (value.sourceRef === undefined || typeof value.sourceRef === 'string') &&
+        (value.description === undefined || typeof value.description === 'string') &&
+        (value.entrypoint === undefined || typeof value.entrypoint === 'string') &&
+        (value.tags === undefined || isOptionalStringArray(value.tags)) &&
+        (value.managedBy === undefined || typeof value.managedBy === 'string'));
+}
+export function assertAssetMetadata(value, context) {
+    if (!isAssetMetadata(value)) {
+        throw new HarnessError('ASSET_METADATA_INVALID', `Invalid asset metadata in ${context}. "hash" is required and must be non-empty.`);
+    }
+}
+export function serializeAssetMetadata(metadata) {
+    assertAssetMetadata(metadata, 'serializeAssetMetadata');
+    return JSON.stringify(metadata);
+}
+export function parseAssetMetadata(serialized) {
+    const parsed = JSON.parse(serialized);
+    assertAssetMetadata(parsed, 'parseAssetMetadata');
+    return parsed;
+}
+export function serializeLocalRuleMetadataStore(store) {
+    if (!isObject(store) || store.version !== 1 || !Array.isArray(store.records)) {
+        throw new HarnessError('RULE_METADATA_INVALID_STORE', 'Rule metadata store must include version=1 and records array.');
+    }
+    for (const record of store.records) {
+        if (!isObject(record) || typeof record.ruleName !== 'string' || typeof record.targetPath !== 'string') {
+            throw new HarnessError('RULE_METADATA_INVALID_RECORD', 'Rule metadata record is malformed.');
+        }
+        assertAssetMetadata(record.metadata, 'rule metadata store');
+    }
+    return `${JSON.stringify(store, null, 2)}\n`;
+}
+export function serializeLocalCommandMetadataStore(store) {
+    if (!isObject(store) || store.version !== 1 || !Array.isArray(store.records)) {
+        throw new HarnessError('COMMAND_METADATA_INVALID_STORE', 'Command metadata store must include version=1 and records array.');
+    }
+    for (const record of store.records) {
+        if (!isObject(record) ||
+            typeof record.commandName !== 'string' ||
+            typeof record.targetPath !== 'string') {
+            throw new HarnessError('COMMAND_METADATA_INVALID_RECORD', 'Command metadata record is malformed.');
+        }
+        assertAssetMetadata(record.metadata, 'command metadata store');
+    }
+    return `${JSON.stringify(store, null, 2)}\n`;
+}
+export function parseLocalRuleMetadataStore(serialized) {
+    const parsed = JSON.parse(serialized);
+    if (!isObject(parsed) || parsed.version !== 1 || !Array.isArray(parsed.records)) {
+        throw new HarnessError('RULE_METADATA_INVALID_STORE', 'Rule metadata store must include version=1 and records array.');
+    }
+    const records = parsed.records.map((record) => {
+        if (!isObject(record) || typeof record.ruleName !== 'string' || typeof record.targetPath !== 'string') {
+            throw new HarnessError('RULE_METADATA_INVALID_RECORD', 'Rule metadata record is malformed.');
+        }
+        assertAssetMetadata(record.metadata, 'rule metadata store');
+        return {
+            ruleName: record.ruleName,
+            targetPath: record.targetPath,
+            metadata: record.metadata,
+        };
+    });
+    return {
+        version: 1,
+        records,
+    };
+}
+export function parseLocalPromptMetadataStore(serialized) {
+    const parsed = JSON.parse(serialized);
+    if (!isObject(parsed) || parsed.version !== 1 || !Array.isArray(parsed.records)) {
+        throw new HarnessError('PROMPT_METADATA_INVALID_STORE', 'Prompt metadata store must include version=1 and records array.');
+    }
+    const records = parsed.records.map((record) => {
+        if (!isObject(record) || typeof record.promptName !== 'string' || typeof record.targetPath !== 'string') {
+            throw new HarnessError('PROMPT_METADATA_INVALID_RECORD', 'Prompt metadata record is malformed.');
+        }
+        assertAssetMetadata(record.metadata, 'prompt metadata store');
+        return {
+            promptName: record.promptName,
+            targetPath: record.targetPath,
+            metadata: record.metadata,
+        };
+    });
+    return {
+        version: 1,
+        records,
+    };
+}
+export function parseLocalMcpConfigMetadataStore(serialized) {
+    const parsed = JSON.parse(serialized);
+    if (!isObject(parsed) || parsed.version !== 1 || !Array.isArray(parsed.records)) {
+        throw new HarnessError('MCP_METADATA_INVALID_STORE', 'MCP metadata store must include version=1 and records array.');
+    }
+    const records = parsed.records.map((record) => {
+        if (!isObject(record) || typeof record.mcpConfigName !== 'string' || typeof record.targetPath !== 'string') {
+            throw new HarnessError('MCP_METADATA_INVALID_RECORD', 'MCP metadata record is malformed.');
+        }
+        assertAssetMetadata(record.metadata, 'mcp metadata store');
+        return {
+            mcpConfigName: record.mcpConfigName,
+            targetPath: record.targetPath,
+            metadata: record.metadata,
+        };
+    });
+    return {
+        version: 1,
+        records,
+    };
+}
+export function parseLocalCommandMetadataStore(serialized) {
+    const parsed = JSON.parse(serialized);
+    if (!isObject(parsed) || parsed.version !== 1 || !Array.isArray(parsed.records)) {
+        throw new HarnessError('COMMAND_METADATA_INVALID_STORE', 'Command metadata store must include version=1 and records array.');
+    }
+    const records = parsed.records.map((record) => {
+        if (!isObject(record) ||
+            typeof record.commandName !== 'string' ||
+            typeof record.targetPath !== 'string') {
+            throw new HarnessError('COMMAND_METADATA_INVALID_RECORD', 'Command metadata record is malformed.');
+        }
+        assertAssetMetadata(record.metadata, 'command metadata store');
+        return {
+            commandName: record.commandName,
+            targetPath: record.targetPath,
+            metadata: record.metadata,
+        };
+    });
+    return {
+        version: 1,
+        records,
+    };
+}
+//# sourceMappingURL=metadata.js.map

package/dist/assets/metadata.js.map

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

package/dist/assets/project-manifest.d.ts

@@ -0,0 +1,80 @@
+import type { AssetMetadata } from './metadata.js';
+import type { InstalledSkillRecord } from '../skills/types.js';
+export declare const DEFAULT_PROJECT_MANIFEST_RELATIVE_PATH: ".cursor/harness-assets.json";
+export declare const LEGACY_SKILL_REGISTRY_FILENAME: "harness-skill-registry.json";
+export declare const PROJECT_MANIFEST_SCHEMA_VERSION: "harness.cursor-assets.v3";
+/** @deprecated v2 字段，读取时迁移到 {@link ProjectAssetRegistryEntry} */
+export type CursorAssetType = 'command' | 'skill' | 'rule' | 'mcp-config' | 'spec' | 'unknown';
+/** @deprecated v2 资产行，读取时迁移 */
+export interface CursorTrackedAsset {
+    id: string;
+    type: CursorAssetType;
+    targetPath: string;
+    version: string;
+    source: string;
+    reason: string | null;
+}
+/**
+ * 项目内可升级资产登记（init 与 skill install 共用 `installed` 字段）。
+ * Skill 元数据统一写入 {@link AssetMetadata}；legacy 顶层 skill 字段读取时会合并进 assetMetadata。
+ */
+export interface ProjectAssetRegistryEntry {
+    id: string;
+    installPath: string;
+    installedAt: string;
+    /** 安装来源：配置包 id，或 {@link MANUAL_INSTALL_FROM}；首次写入后不可变。 */
+    installFrom: string;
+    assetMetadata: AssetMetadata;
+    /** @deprecated 读取时合并进 assetMetadata，写入时不再输出。 */
+    skillName?: string;
+    /** @deprecated 读取时合并进 assetMetadata，写入时不再输出。 */
+    source?: InstalledSkillRecord['source'];
+    /** @deprecated 读取时合并进 assetMetadata.sourceRef，写入时不再输出。 */
+    sourceRef?: string;
+    /** @deprecated 读取时合并进 assetMetadata.revision，写入时不再输出。 */
+    revision?: string | null;
+    /** @deprecated 读取时合并进 assetMetadata，写入时不再输出。 */
+    manifest?: InstalledSkillRecord['manifest'];
+}
+/** 与 {@link ConfigPackAssetType} 对齐；manifest 独立声明以避免 assets 与 init 循环依赖。 */
+export type ProjectManifestConfigPackAssetType = 'skill' | 'rule' | 'spec' | 'mcp-config' | 'command';
+/** 配置包内原子资产绑定：仅类型 + 名称；UUID、路径、版本等与 {@link installed} 对齐。 */
+export interface ProjectManifestConfigPackAssetBinding {
+    readonly assetType: ProjectManifestConfigPackAssetType;
+    readonly name: string;
+}
+/** init 命中的配置包摘要（与 `installed` 并存，便于追溯与展示）。 */
+export interface ProjectManifestConfigPack {
+    readonly id: string;
+    readonly name: string;
+    readonly version: string;
+    readonly hitReason: string;
+    readonly assets: readonly ProjectManifestConfigPackAssetBinding[];
+}
+export interface HarnessProjectManifest {
+    schemaVersion: string;
+    generatedBy?: string;
+    cloudPlanSource?: string | null;
+    /** init / install 关联的配置包列表；`assets` 仅含类型与名称。 */
+    configPacks?: readonly ProjectManifestConfigPack[];
+    installed: ProjectAssetRegistryEntry[];
+}
+/** 将 legacy 顶层 skill 字段合并进 assetMetadata。 */
+export declare function mergeLegacyFieldsIntoAssetMetadata(entry: ProjectAssetRegistryEntry): AssetMetadata;
+export declare function compactProjectAssetRegistryEntry(entry: ProjectAssetRegistryEntry): ProjectAssetRegistryEntry;
+export declare function projectEntryToInstalledSkillRecord(entry: ProjectAssetRegistryEntry): InstalledSkillRecord | null;
+export declare function getManifestConfigPacks(manifest: Pick<HarnessProjectManifest, 'configPacks'>): readonly ProjectManifestConfigPack[];
+export declare function resolveProjectManifestPath(workspaceRoot: string): string;
+export declare function isProjectManifestPath(filePath: string): boolean;
+export declare function readProjectManifest(filePath: string): Promise<HarnessProjectManifest>;
+export declare function writeProjectManifest(filePath: string, manifest: HarnessProjectManifest): Promise<void>;
+export declare function readProjectInstalledSkills(filePath: string): Promise<InstalledSkillRecord[]>;
+export declare function writeProjectInstalledSkills(filePath: string, installed: InstalledSkillRecord[]): Promise<void>;
+export declare function createInitProjectManifest(args: {
+    generatedBy?: string;
+    cloudPlanSource?: string | null;
+    installed: ProjectAssetRegistryEntry[];
+    configPacks?: readonly ProjectManifestConfigPack[] | null;
+}): HarnessProjectManifest;
+export declare function upsertManifestConfigPack(existing: readonly ProjectManifestConfigPack[] | undefined, next: ProjectManifestConfigPack): ProjectManifestConfigPack[];
+//# sourceMappingURL=project-manifest.d.ts.map

package/dist/assets/project-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-manifest.d.ts","sourceRoot":"","sources":["../../src/assets/project-manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAE,oBAAoB,EAA8B,MAAM,oBAAoB,CAAC;AAK3F,eAAO,MAAM,sCAAsC,EAAG,6BAAsC,CAAC;AAC7F,eAAO,MAAM,8BAA8B,EAAG,6BAAsC,CAAC;AACrF,eAAO,MAAM,+BAA+B,EAAG,0BAAmC,CAAC;AAKnF,iEAAiE;AACjE,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/F,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,MAAM,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACxC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC;CAC7C;AAED,4EAA4E;AAC5E,MAAM,MAAM,kCAAkC,GAC1C,OAAO,GACP,MAAM,GACN,MAAM,GACN,YAAY,GACZ,SAAS,CAAC;AAEd,6DAA6D;AAC7D,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,SAAS,EAAE,kCAAkC,CAAC;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,+CAA+C;AAC/C,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,qCAAqC,EAAE,CAAC;CACnE;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gDAAgD;IAChD,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACnD,SAAS,EAAE,yBAAyB,EAAE,CAAC;CACxC;AAeD,6CAA6C;AAC7C,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,yBAAyB,GAAG,aAAa,CA0BlG;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,yBAAyB,GAAG,yBAAyB,CAQ5G;AAaD,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,yBAAyB,GAAG,oBAAoB,GAAG,IAAI,CAgBhH;AA2UD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,IAAI,CAAC,sBAAsB,EAAE,aAAa,CAAC,GACpD,SAAS,yBAAyB,EAAE,CAEtC;AAoGD,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA8B3F;AAMD,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAY5G;AAED,wBAAsB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAMlG;AAED,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,oBAAoB,EAAE,GAChC,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,yBAAyB,EAAE,CAAC;IACvC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,GAAG,IAAI,CAAC;CAC3D,GAAG,sBAAsB,CAQzB;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,SAAS,yBAAyB,EAAE,GAAG,SAAS,EAC1D,IAAI,EAAE,yBAAyB,GAC9B,yBAAyB,EAAE,CAS7B"}