@ytinnovation/harness-core 0.0.0

package/dist/skills/list-scan.js

@@ -0,0 +1,230 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join, relative, sep } from 'node:path';
+/** Only these top-level directories are scanned for skills (per product convention). */
+export const SKILL_SCAN_TOP_LEVEL_DIRS = ['.agents', '.cursor'];
+function toPosixRelative(fromRoot, absolutePath) {
+    const rel = relative(fromRoot, absolutePath);
+    return rel.split(sep).join('/');
+}
+function yamlKeyToCamel(key) {
+    return key.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+/**
+ * Minimal YAML-ish frontmatter parser (single-line values, quoted strings).
+ * Sufficient for SKILL.md headers used by agent-skills style layouts.
+ */
+export function parseSimpleYamlFrontmatter(markdown) {
+    const trimmed = markdown.trimStart();
+    if (!trimmed.startsWith('---')) {
+        return {};
+    }
+    const afterOpen = trimmed.slice(3).replace(/^\r?\n/, '');
+    const endMatch = afterOpen.match(/\r?\n---\r?\n/);
+    if (!endMatch || endMatch.index === undefined) {
+        return {};
+    }
+    const block = afterOpen.slice(0, endMatch.index);
+    const out = {};
+    for (const rawLine of block.split(/\n/)) {
+        const line = rawLine.trimEnd();
+        if (!line || line.startsWith('#')) {
+            continue;
+        }
+        const colon = line.indexOf(':');
+        if (colon === -1) {
+            continue;
+        }
+        const rawKey = line.slice(0, colon).trim();
+        let value = line.slice(colon + 1).trim();
+        if (value.startsWith('"') && value.endsWith('"')) {
+            value = value.slice(1, -1).replace(/\\"/g, '"');
+        }
+        const camelKey = yamlKeyToCamel(rawKey);
+        out[camelKey] = value;
+    }
+    return out;
+}
+function isHarnessManagedMeta(meta) {
+    const v = meta.managedBy?.trim().toLowerCase();
+    return v === 'harness';
+}
+function buildManifestFromFrontmatter(meta) {
+    const name = meta.name?.trim();
+    const description = meta.description?.trim();
+    if (!name || !description) {
+        return null;
+    }
+    const version = meta.version?.trim() || '0.0.0';
+    const entrypoint = meta.entrypoint?.trim() || 'SKILL.md';
+    const tagsRaw = meta.tags?.trim();
+    const tags = tagsRaw && tagsRaw.startsWith('[') && tagsRaw.endsWith(']')
+        ? tagsRaw
+            .slice(1, -1)
+            .split(',')
+            .map((t) => t.trim().replace(/^"|"$/g, ''))
+            .filter(Boolean)
+        : tagsRaw
+            ? [tagsRaw.replace(/^"|"$/g, '')]
+            : [];
+    const manifest = {
+        name,
+        version,
+        description,
+        entrypoint,
+        tags,
+    };
+    if (isHarnessManagedMeta(meta)) {
+        manifest.managedBy = 'harness';
+    }
+    if (meta.author?.trim()) {
+        manifest.author = meta.author.trim();
+    }
+    if (meta.repository?.trim()) {
+        manifest.repository = meta.repository.trim();
+    }
+    return manifest;
+}
+function parseManifestJson(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return null;
+    }
+    const o = parsed;
+    const name = typeof o.name === 'string' ? o.name.trim() : '';
+    const description = typeof o.description === 'string' ? o.description.trim() : '';
+    if (!name || !description) {
+        return null;
+    }
+    const version = typeof o.version === 'string' ? o.version.trim() : '0.0.0';
+    const entrypoint = typeof o.entrypoint === 'string' ? o.entrypoint.trim() : 'SKILL.md';
+    const tags = Array.isArray(o.tags) ? o.tags.filter((t) => typeof t === 'string') : [];
+    const managedBy = typeof o.managedBy === 'string' ? o.managedBy.trim().toLowerCase() : '';
+    const manifest = {
+        name,
+        version,
+        description,
+        entrypoint,
+        tags,
+    };
+    if (managedBy === 'harness') {
+        manifest.managedBy = 'harness';
+    }
+    if (typeof o.author === 'string' && o.author.trim()) {
+        manifest.author = o.author.trim();
+    }
+    if (typeof o.repository === 'string' && o.repository.trim()) {
+        manifest.repository = o.repository.trim();
+    }
+    return manifest;
+}
+async function walkFiles(dir, onFile) {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const ent of entries) {
+        const abs = join(dir, ent.name);
+        if (ent.isDirectory()) {
+            await walkFiles(abs, onFile);
+        }
+        else if (ent.isFile()) {
+            onFile(abs);
+        }
+    }
+}
+async function readSkillEntry(workspaceRoot, absolutePath, kind) {
+    const relativePath = toPosixRelative(workspaceRoot, absolutePath);
+    const skillRoot = toPosixRelative(workspaceRoot, join(absolutePath, '..'));
+    let manifest = null;
+    let reason;
+    try {
+        const raw = await readFile(absolutePath, 'utf8');
+        if (kind === 'manifest-json') {
+            manifest = parseManifestJson(raw);
+            if (!manifest) {
+                reason = 'invalid-manifest-json';
+            }
+        }
+        else {
+            const meta = parseSimpleYamlFrontmatter(raw);
+            manifest = buildManifestFromFrontmatter(meta);
+            if (!manifest) {
+                reason = 'invalid-skill-md-frontmatter';
+            }
+            else if (!isHarnessManagedMeta(meta)) {
+                reason = 'not-harness-managed';
+            }
+        }
+        if (kind === 'manifest-json' && manifest && manifest.managedBy !== 'harness') {
+            reason = 'not-harness-managed';
+        }
+    }
+    catch {
+        reason = 'unreadable-file';
+    }
+    return {
+        relativePath,
+        skillRoot,
+        kind,
+        manifest,
+        reason,
+    };
+}
+/**
+ * Recursively scan `.agents` and `.cursor` under the workspace for `SKILL.md` and `manifest.json`.
+ * Entries with a valid {@link SkillManifest} and `managedBy: "harness"` are {@link SkillScanResult.maintained};
+ * all other discovered skill files go to {@link SkillScanResult.other}.
+ */
+export async function scanWorkspaceSkills(workspaceRoot) {
+    const maintained = [];
+    const other = [];
+    const candidates = [];
+    for (const top of SKILL_SCAN_TOP_LEVEL_DIRS) {
+        const root = join(workspaceRoot, top);
+        try {
+            const st = await stat(root);
+            if (!st.isDirectory()) {
+                continue;
+            }
+        }
+        catch {
+            continue;
+        }
+        await walkFiles(root, (abs) => {
+            const base = abs.split(/[/\\]/).pop();
+            if (base === 'SKILL.md') {
+                candidates.push({ abs, kind: 'skill-md' });
+            }
+            else if (base === 'manifest.json') {
+                candidates.push({ abs, kind: 'manifest-json' });
+            }
+        });
+    }
+    for (const { abs, kind } of candidates) {
+        const entry = await readSkillEntry(workspaceRoot, abs, kind);
+        if (entry.manifest?.managedBy === 'harness') {
+            const { reason: _omit, ...rest } = entry;
+            maintained.push(rest);
+        }
+        else {
+            other.push({
+                ...entry,
+                reason: entry.reason ?? (entry.manifest ? 'not-harness-managed' : 'invalid-or-missing-manifest'),
+            });
+        }
+    }
+    const byPath = (a, b) => a.relativePath.localeCompare(b.relativePath);
+    maintained.sort(byPath);
+    other.sort(byPath);
+    return { maintained, other };
+}
+//# sourceMappingURL=list-scan.js.map

package/dist/skills/list-scan.js.map

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

package/dist/skills/metadata.d.ts

@@ -0,0 +1,5 @@
+import { type AssetMetadata } from '../assets/metadata.js';
+import type { InstalledSkillRecord, LegacyInstalledSkillRecord } from './types.js';
+export declare function createSkillAssetMetadata(record: LegacyInstalledSkillRecord): AssetMetadata;
+export declare function normalizeInstalledSkillRecord(record: LegacyInstalledSkillRecord | InstalledSkillRecord): InstalledSkillRecord;
+//# sourceMappingURL=metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/skills/metadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EAAE,oBAAoB,EAAE,0BAA0B,EAAe,MAAM,YAAY,CAAC;AAkBhG,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,0BAA0B,GAAG,aAAa,CAgB1F;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,0BAA0B,GAAG,oBAAoB,GACxD,oBAAoB,CAUtB"}

package/dist/skills/metadata.js

@@ -0,0 +1,44 @@
+import { createHash } from 'node:crypto';
+import { assertAssetMetadata } from '../assets/metadata.js';
+function toReviewStatus(source) {
+    return source === 'internal' ? 'approved' : 'unreviewed';
+}
+function buildStableSkillHash(record) {
+    const payload = JSON.stringify({
+        skillName: record.skillName,
+        version: record.manifest.version,
+        source: record.source,
+        sourceRef: record.sourceRef,
+        revision: record.revision,
+        installedAt: record.installedAt,
+    });
+    return createHash('sha256').update(payload).digest('hex');
+}
+export function createSkillAssetMetadata(record) {
+    return {
+        assetType: 'skill',
+        name: record.skillName,
+        version: record.manifest.version,
+        hash: buildStableSkillHash(record),
+        source: record.sourceRef,
+        sourceRef: record.sourceRef,
+        revision: record.revision,
+        reviewStatus: toReviewStatus(record.source),
+        installedAt: record.installedAt,
+        description: record.manifest.description,
+        entrypoint: record.manifest.entrypoint,
+        tags: record.manifest.tags,
+        ...(record.manifest.managedBy ? { managedBy: record.manifest.managedBy } : {}),
+    };
+}
+export function normalizeInstalledSkillRecord(record) {
+    if ('assetMetadata' in record) {
+        assertAssetMetadata(record.assetMetadata, 'installed skill record');
+        return record;
+    }
+    return {
+        ...record,
+        assetMetadata: createSkillAssetMetadata(record),
+    };
+}
+//# sourceMappingURL=metadata.js.map

package/dist/skills/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/skills/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAsB,MAAM,uBAAuB,CAAC;AAGhF,SAAS,cAAc,CAAC,MAAmB;IACzC,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC;AAC3D,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAkC;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;QAChC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC;IACH,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAkC;IACzE,OAAO;QACL,SAAS,EAAE,OAAO;QAClB,IAAI,EAAE,MAAM,CAAC,SAAS;QACtB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;QAChC,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC;QAClC,MAAM,EAAE,MAAM,CAAC,SAAS;QACxB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC;QAC3C,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW;QACxC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU;QACtC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;QAC1B,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,MAAyD;IAEzD,IAAI,eAAe,IAAI,MAAM,EAAE,CAAC;QAC9B,mBAAmB,CAAC,MAAM,CAAC,aAAa,EAAE,wBAAwB,CAAC,CAAC;QACpE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,aAAa,EAAE,wBAAwB,CAAC,MAAM,CAAC;KAChD,CAAC;AACJ,CAAC"}

package/dist/skills/providers/harness-service.d.ts

@@ -0,0 +1,11 @@
+import { EnterpriseAssetClient } from '../../cloud/enterprise-asset-client.js';
+import type { InternalSkillProvider } from '../types.js';
+export interface HarnessServiceInternalSkillProviderOptions {
+    readonly client: EnterpriseAssetClient;
+    readonly scope?: string;
+}
+/** `harness-service://asset/<uuid>` — 写入 registry `sourceRef` 以便更新检测解析 assetId */
+export declare function formatEnterpriseSkillSourceRef(assetId: string): string;
+export declare function parseEnterpriseAssetIdFromSourceRef(sourceRef: string): string | undefined;
+export declare function createHarnessServiceInternalSkillProvider(options: HarnessServiceInternalSkillProviderOptions): InternalSkillProvider;
+//# sourceMappingURL=harness-service.d.ts.map

package/dist/skills/providers/harness-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-service.d.ts","sourceRoot":"","sources":["../../../src/skills/providers/harness-service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E,OAAO,KAAK,EAAE,qBAAqB,EAA2C,MAAM,aAAa,CAAC;AAKlG,MAAM,WAAW,0CAA0C;IACzD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,kFAAkF;AAClF,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,mCAAmC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGzF;AAyDD,wBAAgB,yCAAyC,CACvD,OAAO,EAAE,0CAA0C,GAClD,qBAAqB,CAyDvB"}

package/dist/skills/providers/harness-service.js

@@ -0,0 +1,111 @@
+import { HarnessError } from '../../contracts/errors.js';
+import { injectInstalledAssetIdHeader } from '../../assets/install-content.js';
+import { EnterpriseAssetClient } from '../../cloud/enterprise-asset-client.js';
+import { parseSkillManifestFromSkillMarkdown } from '../skill-markdown-manifest.js';
+const SOURCE_LABEL = 'Harness Enterprise Service';
+/** `harness-service://asset/<uuid>` — 写入 registry `sourceRef` 以便更新检测解析 assetId */
+export function formatEnterpriseSkillSourceRef(assetId) {
+    return `harness-service://asset/${assetId}`;
+}
+export function parseEnterpriseAssetIdFromSourceRef(sourceRef) {
+    const m = /^harness-service:\/\/asset\/([0-9a-f-]{36})$/i.exec(sourceRef.trim());
+    return m?.[1];
+}
+function toSearchResult(item) {
+    const desc = item.description?.trim() ?? item.name;
+    return {
+        skillName: item.name,
+        description: desc,
+        source: 'internal',
+        sourceLabel: SOURCE_LABEL,
+        matchMethod: 'name-fuzzy',
+        reviewStatus: 'approved',
+        installable: true,
+        latestRevision: item.latestPublished?.version ?? null,
+    };
+}
+function buildManifestFromEnterpriseSkill(asset, content, versionLabel) {
+    const parsed = content ? parseSkillManifestFromSkillMarkdown(content) : null;
+    if (parsed) {
+        return { manifest: parsed, revision: versionLabel };
+    }
+    const meta = asset.metadata && typeof asset.metadata === 'object' && !Array.isArray(asset.metadata)
+        ? asset.metadata
+        : undefined;
+    const mName = typeof meta?.name === 'string' ? meta.name : asset.name;
+    const mVersion = typeof meta?.version === 'string' ? meta.version : versionLabel;
+    const mDesc = typeof meta?.description === 'string' ? meta.description : asset.description ?? mName;
+    const mEntry = typeof meta?.entrypoint === 'string' ? meta.entrypoint : `skills/${asset.name}/SKILL.md`;
+    const mTags = Array.isArray(meta?.tags)
+        ? meta.tags.filter((t) => typeof t === 'string')
+        : [];
+    const manifest = {
+        name: mName,
+        version: mVersion,
+        description: mDesc,
+        entrypoint: mEntry,
+        tags: mTags,
+    };
+    if (meta?.managedBy === 'harness') {
+        manifest.managedBy = 'harness';
+    }
+    return {
+        manifest,
+        revision: versionLabel,
+    };
+}
+export function createHarnessServiceInternalSkillProvider(options) {
+    const { client, scope = '' } = options;
+    return {
+        async search(query) {
+            const q = query.trim();
+            if (!q) {
+                return [];
+            }
+            const items = await client.searchPublished({
+                type: 'skill',
+                query: q,
+                scope: scope !== '' ? scope : undefined,
+            });
+            return items.map(toSearchResult);
+        },
+        async resolveByName(name) {
+            const trimmed = name.trim();
+            if (!trimmed) {
+                return null;
+            }
+            const candidates = await client.searchPublished({
+                type: 'skill',
+                query: trimmed,
+                scope: scope !== '' ? scope : undefined,
+            });
+            const exact = candidates.find((c) => c.name === trimmed && (c.scope ?? '') === scope) ??
+                candidates.find((c) => c.name === trimmed);
+            if (!exact) {
+                return null;
+            }
+            const detail = await client.getAssetDetail(exact.id);
+            if (!detail?.latestPublished) {
+                return null;
+            }
+            const version = detail.latestPublished.version;
+            const body = await client.getPublishedVersion(exact.id, version);
+            if (!body?.content) {
+                throw new HarnessError('SKILL_NOT_FOUND', `Enterprise skill "${trimmed}" has no published body.`);
+            }
+            const commitSha = typeof body.contentCommitSha === 'string' && body.contentCommitSha.trim() !== ''
+                ? body.contentCommitSha
+                : null;
+            const built = buildManifestFromEnterpriseSkill(detail, body.content, commitSha ?? version);
+            const rawContent = body.content ?? '';
+            const content = rawContent ? injectInstalledAssetIdHeader(rawContent, exact.id) : rawContent;
+            return {
+                manifest: built.manifest,
+                revision: commitSha ?? built.revision,
+                content,
+                sourceRef: formatEnterpriseSkillSourceRef(exact.id),
+            };
+        },
+    };
+}
+//# sourceMappingURL=harness-service.js.map

package/dist/skills/providers/harness-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-service.js","sourceRoot":"","sources":["../../../src/skills/providers/harness-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAG/E,OAAO,EAAE,mCAAmC,EAAE,MAAM,+BAA+B,CAAC;AAEpF,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAOlD,kFAAkF;AAClF,MAAM,UAAU,8BAA8B,CAAC,OAAe;IAC5D,OAAO,2BAA2B,OAAO,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,SAAiB;IACnE,MAAM,CAAC,GAAG,+CAA+C,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IACjF,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,IAKvB;IACC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC;IACnD,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,IAAI;QACpB,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,YAAY;QACzB,WAAW,EAAE,YAAY;QACzB,YAAY,EAAE,UAAU;QACxB,WAAW,EAAE,IAAI;QACjB,cAAc,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,IAAI,IAAI;KACtD,CAAC;AACJ,CAAC;AAED,SAAS,gCAAgC,CACvC,KAA2E,EAC3E,OAAsB,EACtB,YAAoB;IAEpB,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,mCAAmC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IACtD,CAAC;IACD,MAAM,IAAI,GACR,KAAK,CAAC,QAAQ,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QACpF,CAAC,CAAE,KAAK,CAAC,QAAoC;QAC7C,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,KAAK,GAAG,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IACtE,MAAM,QAAQ,GAAG,OAAO,IAAI,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;IACjF,MAAM,KAAK,GAAG,OAAO,IAAI,EAAE,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC;IACpG,MAAM,MAAM,GAAG,OAAO,IAAI,EAAE,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,IAAI,WAAW,CAAC;IACxG,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;QACrC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;QAC7D,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,QAAQ,GAAqC;QACjD,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,QAAQ;QACjB,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,MAAM;QAClB,IAAI,EAAE,KAAK;KACZ,CAAC;IACF,IAAI,IAAI,EAAE,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;IACjC,CAAC;IACD,OAAO;QACL,QAAQ;QACR,QAAQ,EAAE,YAAY;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yCAAyC,CACvD,OAAmD;IAEnD,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAEvC,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,KAAa;YACxB,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,CAAC,EAAE,CAAC;gBACP,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;gBACzC,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aACxC,CAAC,CAAC;YACH,OAAO,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACnC,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,IAAY;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;gBAC9C,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aACxC,CAAC,CAAC;YACH,MAAM,KAAK,GACT,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,KAAK,CAAC;gBACvE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC;YAC/C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YACjE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnB,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,qBAAqB,OAAO,0BAA0B,CAAC,CAAC;YACpG,CAAC;YACD,MAAM,SAAS,GACb,OAAO,IAAI,CAAC,gBAAgB,KAAK,QAAQ,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE;gBAC9E,CAAC,CAAC,IAAI,CAAC,gBAAgB;gBACvB,CAAC,CAAC,IAAI,CAAC;YACX,MAAM,KAAK,GAAG,gCAAgC,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,IAAI,OAAO,CAAC,CAAC;YAC3F,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,4BAA4B,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;YAC7F,OAAO;gBACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,QAAQ,EAAE,SAAS,IAAI,KAAK,CAAC,QAAQ;gBACrC,OAAO;gBACP,SAAS,EAAE,8BAA8B,CAAC,KAAK,CAAC,EAAE,CAAC;aACpD,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/skills/providers/stub.d.ts

@@ -0,0 +1,4 @@
+import type { ExternalSkillProvider, InternalSkillProvider } from '../types.js';
+export declare function createStubInternalProvider(): InternalSkillProvider;
+export declare function createStubExternalProvider(): ExternalSkillProvider;
+//# sourceMappingURL=stub.d.ts.map

package/dist/skills/providers/stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.d.ts","sourceRoot":"","sources":["../../../src/skills/providers/stub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEhF,wBAAgB,0BAA0B,IAAI,qBAAqB,CASlE;AAED,wBAAgB,0BAA0B,IAAI,qBAAqB,CAMlE"}

package/dist/skills/providers/stub.js

@@ -0,0 +1,18 @@
+export function createStubInternalProvider() {
+    return {
+        async resolveByName() {
+            return null;
+        },
+        async search() {
+            return [];
+        },
+    };
+}
+export function createStubExternalProvider() {
+    return {
+        async search() {
+            return [];
+        },
+    };
+}
+//# sourceMappingURL=stub.js.map

package/dist/skills/providers/stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.js","sourceRoot":"","sources":["../../../src/skills/providers/stub.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,KAAK,CAAC,aAAa;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,CAAC,MAAM;YACV,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,KAAK,CAAC,MAAM;YACV,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/skills/publish.d.ts

@@ -0,0 +1,35 @@
+import type { SkillManifest, SkillPublishApprovalWebhookPayload, SkillPublishBackend, SkillPublishMergeRequest, SkillPublishPushResult, SkillPublishRequest, SkillPublishResult } from './types.js';
+export interface SkillGitIdentity {
+    name: string | null;
+    email: string | null;
+}
+export interface PrepareSkillPublishOptions {
+    backend: SkillPublishBackend;
+    repositoryPath: string;
+    targetDirectory: string;
+    branchName: string;
+    commitMessage: string;
+    targetBranch?: string;
+    mergeRequestTitle?: string;
+    mergeRequestDescription?: string;
+    cwd?: string;
+    resolveGitIdentity?: (cwd: string) => Promise<SkillGitIdentity>;
+    manifestPath?: string;
+}
+export interface SkillPublishGitLabClient {
+    pushSkill(request: SkillPublishRequest): Promise<SkillPublishPushResult>;
+    createMergeRequest(request: SkillPublishRequest): Promise<SkillPublishMergeRequest>;
+}
+export interface SkillPublishApprovalWebhookSender {
+    send(payload: SkillPublishApprovalWebhookPayload): Promise<void>;
+}
+export interface CreateGitLabSkillPublishBackendOptions {
+    client: SkillPublishGitLabClient;
+    approvalWebhookSender?: SkillPublishApprovalWebhookSender;
+    requireApproval?: boolean;
+    now?: () => Date;
+}
+export declare function resolveLocalSkillGitIdentity(cwd: string): Promise<SkillGitIdentity>;
+export declare function prepareSkillPublish(manifest: SkillManifest, options: PrepareSkillPublishOptions): Promise<SkillPublishResult>;
+export declare function createGitLabSkillPublishBackend(options: CreateGitLabSkillPublishBackendOptions): SkillPublishBackend;
+//# sourceMappingURL=publish.d.ts.map

package/dist/skills/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/skills/publish.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,kCAAkC,EAClC,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzE,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACrF;AAED,MAAM,WAAW,iCAAiC;IAChD,IAAI,CAAC,OAAO,EAAE,kCAAkC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,sCAAsC;IACrD,MAAM,EAAE,wBAAwB,CAAC;IACjC,qBAAqB,CAAC,EAAE,iCAAiC,CAAC;IAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAcD,wBAAsB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAMzF;AAED,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,kBAAkB,CAAC,CAgC7B;AAuBD,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,sCAAsC,GAC9C,mBAAmB,CAuDrB"}

package/dist/skills/publish.js

@@ -0,0 +1,115 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { HarnessError } from '../contracts/errors.js';
+const execFileAsync = promisify(execFile);
+async function readGitConfigValue(cwd, key) {
+    try {
+        const { stdout } = await execFileAsync('git', ['-C', cwd, 'config', '--local', '--get', key], {
+            timeout: 2_000,
+        });
+        const value = stdout.trim();
+        return value.length > 0 ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function resolveLocalSkillGitIdentity(cwd) {
+    const [name, email] = await Promise.all([
+        readGitConfigValue(cwd, 'user.name'),
+        readGitConfigValue(cwd, 'user.email'),
+    ]);
+    return { name, email };
+}
+export async function prepareSkillPublish(manifest, options) {
+    const cwd = options.cwd ?? process.cwd();
+    const resolveGitIdentity = options.resolveGitIdentity ?? resolveLocalSkillGitIdentity;
+    const gitIdentity = await resolveGitIdentity(cwd);
+    if (!gitIdentity.name || !gitIdentity.email) {
+        throw new HarnessError('SKILL_PUBLISH_MISSING_GIT_IDENTITY', 'Missing local Git identity. Configure user.name and user.email before publishing a skill.');
+    }
+    const request = {
+        manifest,
+        repositoryPath: options.repositoryPath,
+        pushDirectory: options.targetDirectory,
+        branchName: options.branchName,
+        targetBranch: options.targetBranch ?? 'main',
+        commitMessage: options.commitMessage,
+        mergeRequestTitle: options.mergeRequestTitle?.trim() || `Publish ${manifest.name} ${manifest.version}`,
+        mergeRequestDescription: options.mergeRequestDescription?.trim() || options.commitMessage,
+        authorName: gitIdentity.name,
+        authorEmail: gitIdentity.email,
+    };
+    const manifestPath = options.manifestPath?.trim();
+    if (manifestPath) {
+        request.manifestPath = manifestPath;
+    }
+    return options.backend.prepare(request);
+}
+function toApprovalWebhookPayload(request, mergeRequest, now) {
+    return {
+        channel: 'dingtalk',
+        repositoryPath: request.repositoryPath,
+        pushDirectory: request.pushDirectory,
+        branchName: request.branchName,
+        targetBranch: request.targetBranch,
+        mergeRequestId: mergeRequest.id,
+        mergeRequestUrl: mergeRequest.webUrl,
+        skillName: request.manifest.name,
+        skillVersion: request.manifest.version,
+        authorName: request.authorName,
+        authorEmail: request.authorEmail,
+        requestedAt: now.toISOString(),
+    };
+}
+export function createGitLabSkillPublishBackend(options) {
+    return {
+        async prepare(request) {
+            await options.client.pushSkill(request);
+            const mergeRequest = await options.client.createMergeRequest(request);
+            const shouldRequireApproval = options.requireApproval ?? false;
+            if (!shouldRequireApproval) {
+                return {
+                    repositoryPath: request.repositoryPath,
+                    mergeRequest,
+                };
+            }
+            const payload = toApprovalWebhookPayload(request, mergeRequest, (options.now ?? (() => new Date()))());
+            if (!options.approvalWebhookSender) {
+                return {
+                    repositoryPath: request.repositoryPath,
+                    mergeRequest,
+                    approval: {
+                        required: true,
+                        webhookPayload: payload,
+                    },
+                };
+            }
+            try {
+                await options.approvalWebhookSender.send(payload);
+                return {
+                    repositoryPath: request.repositoryPath,
+                    mergeRequest,
+                    approval: {
+                        required: true,
+                        webhookPayload: payload,
+                        webhookStatus: 'sent',
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    repositoryPath: request.repositoryPath,
+                    mergeRequest,
+                    approval: {
+                        required: true,
+                        webhookPayload: payload,
+                        webhookStatus: 'failed',
+                        webhookError: error instanceof Error ? error.message : String(error),
+                    },
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=publish.js.map

package/dist/skills/publish.js.map

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