@ytinnovation/harness-core 0.0.0

package/dist/skills/registry.d.ts

@@ -0,0 +1,24 @@
+import type { InstalledSkillRecord } from './types.js';
+export type SkillRegistryMode = 'project-manifest' | 'skill-only';
+export interface FileSkillRegistryOptions {
+    mode?: SkillRegistryMode;
+}
+export declare class FileSkillRegistry {
+    private readonly filePath;
+    private readonly mode;
+    constructor(filePath: string, options?: FileSkillRegistryOptions);
+    private readInstalled;
+    private writeInstalled;
+    list(): Promise<InstalledSkillRecord[]>;
+    add(record: InstalledSkillRecord): Promise<void>;
+    remove(skillName: string): Promise<boolean>;
+    find(skillName: string): Promise<InstalledSkillRecord | null>;
+}
+export interface SkillRegistry {
+    list(): Promise<InstalledSkillRecord[]>;
+    add(record: InstalledSkillRecord): Promise<void>;
+    remove(skillName: string): Promise<boolean>;
+    find(skillName: string): Promise<InstalledSkillRecord | null>;
+}
+export declare function createFileSkillRegistry(filePath: string, options?: FileSkillRegistryOptions): SkillRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/skills/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAQvD,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,GAAG,YAAY,CAAC;AAiElE,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAH3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;gBAGtB,QAAQ,EAAE,MAAM,EACjC,OAAO,GAAE,wBAA6B;YAK1B,aAAa;YAOb,cAAc;IAQtB,IAAI,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAIvC,GAAG,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBhD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB3C,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;CASpE;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACxC,GAAG,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;CAC/D;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,wBAAwB,GACjC,aAAa,CAEf"}

package/dist/skills/registry.js

@@ -0,0 +1,124 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { normalizeInstalledSkillRecord } from './metadata.js';
+import { isProjectManifestPath, readProjectInstalledSkills, writeProjectInstalledSkills, } from '../assets/project-manifest.js';
+function normalizeSkillName(skillName) {
+    return skillName.trim();
+}
+function isInstalledSkillRecord(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const candidate = value;
+    return (typeof candidate.skillName === 'string' &&
+        typeof candidate.installedAt === 'string' &&
+        (candidate.source === 'internal' || candidate.source === 'external' || candidate.source === 'url') &&
+        typeof candidate.sourceRef === 'string' &&
+        (candidate.revision === null || typeof candidate.revision === 'string') &&
+        (candidate.installPath === undefined ||
+            candidate.installPath === null ||
+            typeof candidate.installPath === 'string') &&
+        !!candidate.manifest &&
+        typeof candidate.manifest === 'object');
+}
+function parseInstalledSkillRecord(value) {
+    if (!isInstalledSkillRecord(value)) {
+        return null;
+    }
+    try {
+        return normalizeInstalledSkillRecord(value);
+    }
+    catch {
+        return null;
+    }
+}
+async function readSkillOnlyRegistryFile(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf8');
+        const parsed = JSON.parse(content);
+        if (!parsed || typeof parsed !== 'object') {
+            return [];
+        }
+        const installed = parsed.installed;
+        if (!Array.isArray(installed)) {
+            return [];
+        }
+        return installed
+            .map((item) => parseInstalledSkillRecord(item))
+            .filter((item) => item !== null);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+}
+async function writeSkillOnlyRegistryFile(filePath, installed) {
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, `${JSON.stringify({ installed }, null, 2)}\n`, 'utf8');
+}
+export class FileSkillRegistry {
+    filePath;
+    mode;
+    constructor(filePath, options = {}) {
+        this.filePath = filePath;
+        this.mode = options.mode ?? (isProjectManifestPath(filePath) ? 'project-manifest' : 'skill-only');
+    }
+    async readInstalled() {
+        if (this.mode === 'project-manifest') {
+            return readProjectInstalledSkills(this.filePath);
+        }
+        return readSkillOnlyRegistryFile(this.filePath);
+    }
+    async writeInstalled(installed) {
+        if (this.mode === 'project-manifest') {
+            await writeProjectInstalledSkills(this.filePath, installed);
+            return;
+        }
+        await writeSkillOnlyRegistryFile(this.filePath, installed);
+    }
+    async list() {
+        return this.readInstalled();
+    }
+    async add(record) {
+        const normalizedRecord = normalizeInstalledSkillRecord(record);
+        const normalizedSkillName = normalizeSkillName(normalizedRecord.skillName);
+        if (!normalizedSkillName) {
+            return;
+        }
+        const records = await this.readInstalled();
+        const nextRecords = records.filter((item) => normalizeSkillName(item.skillName) !== normalizedSkillName);
+        nextRecords.push({
+            ...normalizedRecord,
+            skillName: normalizedSkillName,
+        });
+        await this.writeInstalled(nextRecords);
+    }
+    async remove(skillName) {
+        const normalizedSkillName = normalizeSkillName(skillName);
+        if (!normalizedSkillName) {
+            return false;
+        }
+        const records = await this.readInstalled();
+        const nextRecords = records.filter((item) => normalizeSkillName(item.skillName) !== normalizedSkillName);
+        const removed = nextRecords.length !== records.length;
+        if (!removed) {
+            return false;
+        }
+        await this.writeInstalled(nextRecords);
+        return true;
+    }
+    async find(skillName) {
+        const normalizedSkillName = normalizeSkillName(skillName);
+        if (!normalizedSkillName) {
+            return null;
+        }
+        const records = await this.readInstalled();
+        return records.find((item) => normalizeSkillName(item.skillName) === normalizedSkillName) ?? null;
+    }
+}
+export function createFileSkillRegistry(filePath, options) {
+    return new FileSkillRegistry(filePath, options);
+}
+//# sourceMappingURL=registry.js.map

package/dist/skills/registry.js.map

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

package/dist/skills/remove.d.ts

@@ -0,0 +1,14 @@
+import type { InstalledSkillRecord, SkillLocalRegistrationEntry } from './types.js';
+export interface RemoveInstalledSkillState {
+    installed: InstalledSkillRecord[];
+    registrations: SkillLocalRegistrationEntry[];
+}
+export interface RemoveInstalledSkillResult {
+    status: 'removed' | 'not-found';
+    skillName: string;
+    removedInstalledRecord: InstalledSkillRecord | null;
+    removedRegistration: SkillLocalRegistrationEntry | null;
+    nextState: RemoveInstalledSkillState;
+}
+export declare function removeInstalledSkill(skillName: string, state: RemoveInstalledSkillState): RemoveInstalledSkillResult;
+//# sourceMappingURL=remove.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../src/skills/remove.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAEpF,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,aAAa,EAAE,2BAA2B,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpD,mBAAmB,EAAE,2BAA2B,GAAG,IAAI,CAAC;IACxD,SAAS,EAAE,yBAAyB,CAAC;CACtC;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,yBAAyB,GAC/B,0BAA0B,CAqD5B"}

package/dist/skills/remove.js

@@ -0,0 +1,44 @@
+export function removeInstalledSkill(skillName, state) {
+    const normalizedSkillName = skillName.trim();
+    if (!normalizedSkillName) {
+        return {
+            status: 'not-found',
+            skillName: normalizedSkillName,
+            removedInstalledRecord: null,
+            removedRegistration: null,
+            nextState: {
+                installed: [...state.installed],
+                registrations: [...state.registrations],
+            },
+        };
+    }
+    const installedIndex = state.installed.findIndex((record) => record.skillName === normalizedSkillName);
+    const registrationIndex = state.registrations.findIndex((entry) => entry.skillName === normalizedSkillName);
+    if (installedIndex === -1 && registrationIndex === -1) {
+        return {
+            status: 'not-found',
+            skillName: normalizedSkillName,
+            removedInstalledRecord: null,
+            removedRegistration: null,
+            nextState: {
+                installed: [...state.installed],
+                registrations: [...state.registrations],
+            },
+        };
+    }
+    const nextInstalled = [...state.installed];
+    const nextRegistrations = [...state.registrations];
+    const removedInstalledRecord = installedIndex === -1 ? null : nextInstalled.splice(installedIndex, 1)[0] ?? null;
+    const removedRegistration = registrationIndex === -1 ? null : nextRegistrations.splice(registrationIndex, 1)[0] ?? null;
+    return {
+        status: 'removed',
+        skillName: normalizedSkillName,
+        removedInstalledRecord,
+        removedRegistration,
+        nextState: {
+            installed: nextInstalled,
+            registrations: nextRegistrations,
+        },
+    };
+}
+//# sourceMappingURL=remove.js.map

package/dist/skills/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../src/skills/remove.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,oBAAoB,CAClC,SAAiB,EACjB,KAAgC;IAEhC,MAAM,mBAAmB,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,SAAS,EAAE,mBAAmB;YAC9B,sBAAsB,EAAE,IAAI;YAC5B,mBAAmB,EAAE,IAAI;YACzB,SAAS,EAAE;gBACT,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;gBAC/B,aAAa,EAAE,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;aACxC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,SAAS,CAAC,SAAS,CAC9C,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,KAAK,mBAAmB,CACrD,CAAC;IACF,MAAM,iBAAiB,GAAG,KAAK,CAAC,aAAa,CAAC,SAAS,CACrD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,mBAAmB,CACnD,CAAC;IAEF,IAAI,cAAc,KAAK,CAAC,CAAC,IAAI,iBAAiB,KAAK,CAAC,CAAC,EAAE,CAAC;QACtD,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,SAAS,EAAE,mBAAmB;YAC9B,sBAAsB,EAAE,IAAI;YAC5B,mBAAmB,EAAE,IAAI;YACzB,SAAS,EAAE;gBACT,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;gBAC/B,aAAa,EAAE,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;aACxC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,iBAAiB,GAAG,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC;IAEnD,MAAM,sBAAsB,GAC1B,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACpF,MAAM,mBAAmB,GACvB,iBAAiB,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAE9F,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,mBAAmB;QAC9B,sBAAsB;QACtB,mBAAmB;QACnB,SAAS,EAAE;YACT,SAAS,EAAE,aAAa;YACxB,aAAa,EAAE,iBAAiB;SACjC;KACF,CAAC;AACJ,CAAC"}

package/dist/skills/search.d.ts

@@ -0,0 +1,9 @@
+import type { ExternalSkillProvider, ExternalSkillVettingProvider, InternalSkillProvider, SkillSearchResult } from './types.js';
+export interface SearchSkillsOptions {
+    internalProvider: InternalSkillProvider;
+    externalProvider: ExternalSkillProvider;
+    maxResults?: number;
+    vettingProvider?: ExternalSkillVettingProvider;
+}
+export declare function searchSkills(query: string, options: SearchSkillsOptions): Promise<SkillSearchResult[]>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/skills/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,4BAA4B,EAC5B,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,4BAA4B,CAAC;CAChD;AAkCD,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA0C9B"}

package/dist/skills/search.js

@@ -0,0 +1,65 @@
+const DEFAULT_SOURCE_LABEL = {
+    internal: 'Harness Internal Catalog',
+    external: 'External Skills Catalog',
+    url: 'Direct URL',
+};
+const DEFAULT_MAX_RESULTS = 12;
+const DEFAULT_EXTERNAL_REVIEW_REASON = 'External result is not installable until vetting is approved.';
+function normalizeMaxResults(maxResults) {
+    if (!Number.isFinite(maxResults) || (maxResults ?? 0) <= 0) {
+        return DEFAULT_MAX_RESULTS;
+    }
+    return Math.min(DEFAULT_MAX_RESULTS, Math.floor(maxResults));
+}
+function normalizeResult(result) {
+    const reviewStatus = result.reviewStatus ?? (result.source === 'external' ? 'unreviewed' : 'approved');
+    const installable = result.installable ?? result.source !== 'url';
+    const notInstallableReason = !installable && result.source === 'external'
+        ? result.notInstallableReason || DEFAULT_EXTERNAL_REVIEW_REASON
+        : result.notInstallableReason;
+    return {
+        ...result,
+        sourceLabel: result.sourceLabel || DEFAULT_SOURCE_LABEL[result.source],
+        matchMethod: result.matchMethod || 'unknown',
+        reviewStatus,
+        installable,
+        notInstallableReason,
+    };
+}
+export async function searchSkills(query, options) {
+    const normalizedQuery = query.trim();
+    if (!normalizedQuery) {
+        return [];
+    }
+    const maxResults = normalizeMaxResults(options.maxResults);
+    const internalResults = (await options.internalProvider.search(normalizedQuery))
+        .map(normalizeResult)
+        .slice(0, maxResults);
+    if (internalResults.length > 0) {
+        return internalResults;
+    }
+    const externalResults = await options.externalProvider.search(normalizedQuery);
+    const vettedExternalResults = await Promise.all(externalResults.map(async (result) => {
+        const normalized = normalizeResult(result);
+        if (!options.vettingProvider) {
+            const reviewStatus = normalized.reviewStatus === 'approved' ? 'approved' : 'unreviewed';
+            return {
+                ...normalized,
+                reviewStatus,
+                installable: reviewStatus === 'approved' ? normalized.installable : false,
+                notInstallableReason: reviewStatus === 'approved'
+                    ? normalized.notInstallableReason
+                    : normalized.notInstallableReason || DEFAULT_EXTERNAL_REVIEW_REASON,
+            };
+        }
+        const vetting = await options.vettingProvider.vet(normalized);
+        return {
+            ...normalized,
+            reviewStatus: vetting.reviewStatus,
+            installable: vetting.installable,
+            notInstallableReason: vetting.installable ? undefined : vetting.reason || DEFAULT_EXTERNAL_REVIEW_REASON,
+        };
+    }));
+    return vettedExternalResults.slice(0, maxResults);
+}
+//# sourceMappingURL=search.js.map

package/dist/skills/search.js.map

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

package/dist/skills/skill-markdown-manifest.d.ts

@@ -0,0 +1,6 @@
+import type { SkillManifest } from './types.js';
+/**
+ * 从 SKILL.md 风格正文中解析 YAML 风格 frontmatter（最小子集，避免引入 yaml 依赖）。
+ */
+export declare function parseSkillManifestFromSkillMarkdown(content: string): SkillManifest | null;
+//# sourceMappingURL=skill-markdown-manifest.d.ts.map

package/dist/skills/skill-markdown-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-markdown-manifest.d.ts","sourceRoot":"","sources":["../../src/skills/skill-markdown-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAmDzF"}

package/dist/skills/skill-markdown-manifest.js

@@ -0,0 +1,57 @@
+/**
+ * 从 SKILL.md 风格正文中解析 YAML 风格 frontmatter（最小子集，避免引入 yaml 依赖）。
+ */
+export function parseSkillManifestFromSkillMarkdown(content) {
+    const trimmed = content.trimStart();
+    const m = /^---\r?\n([\s\S]*?)\r?\n---/.exec(trimmed);
+    const inner = m?.[1];
+    if (inner === undefined) {
+        return null;
+    }
+    const lines = inner.split(/\r?\n/);
+    const map = {};
+    for (const line of lines) {
+        const kv = /^([a-zA-Z0-9_-]+):\s*(.*)$/.exec(line.trim());
+        if (kv && kv[1] !== undefined && kv[2] !== undefined) {
+            map[kv[1]] = kv[2].trim() ?? '';
+        }
+    }
+    const name = map.name ?? '';
+    const version = map.version ?? '';
+    const description = (map.description ?? '').replace(/^["']|["']$/g, '');
+    const entrypoint = map.entrypoint ?? '';
+    if (!name || !version || !description || !entrypoint) {
+        return null;
+    }
+    const tagsRaw = map.tags;
+    let tags = [];
+    if (tagsRaw?.startsWith('[')) {
+        try {
+            const parsed = JSON.parse(tagsRaw);
+            if (Array.isArray(parsed)) {
+                tags = parsed.filter((t) => typeof t === 'string');
+            }
+        }
+        catch {
+            tags = [];
+        }
+    }
+    const manifest = {
+        name,
+        version,
+        description,
+        entrypoint,
+        tags,
+    };
+    if (map.author) {
+        manifest.author = map.author;
+    }
+    if (map.repository) {
+        manifest.repository = map.repository;
+    }
+    if (map.managedBy === 'harness') {
+        manifest.managedBy = 'harness';
+    }
+    return manifest;
+}
+//# sourceMappingURL=skill-markdown-manifest.js.map

package/dist/skills/skill-markdown-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-markdown-manifest.js","sourceRoot":"","sources":["../../src/skills/skill-markdown-manifest.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,mCAAmC,CAAC,OAAe;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IACpC,MAAM,CAAC,GAAG,6BAA6B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1D,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YACrD,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;IACzB,IAAI,IAAI,GAAa,EAAE,CAAC;IACxB,IAAI,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAC;YAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAkB;QAC9B,IAAI;QACJ,OAAO;QACP,WAAW;QACX,UAAU;QACV,IAAI;KACL,CAAC;IACF,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAC/B,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACnB,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IACvC,CAAC;IACD,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAChC,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;IACjC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/skills/types.d.ts

@@ -0,0 +1,138 @@
+import type { AssetMetadata } from '../assets/metadata.js';
+export type SkillSource = 'internal' | 'external' | 'url';
+export type SkillMatchMethod = 'name-exact' | 'name-fuzzy' | 'tag' | 'description' | 'unknown';
+export type SkillReviewStatus = 'approved' | 'unreviewed' | 'rejected';
+export interface SkillManifest {
+    name: string;
+    version: string;
+    description: string;
+    entrypoint: string;
+    tags: string[];
+    author?: string;
+    repository?: string;
+    /** When set to `harness`, the skill is treated as Harness-maintained (eligible for managed updates). */
+    managedBy?: string;
+}
+export interface InstalledSkillRecordBase {
+    skillName: string;
+    installedAt: string;
+    source: SkillSource;
+    sourceRef: string;
+    revision: string | null;
+    installPath?: string | null;
+    manifest: SkillManifest;
+}
+export interface InstalledSkillRecord extends InstalledSkillRecordBase {
+    assetMetadata: AssetMetadata;
+}
+export type LegacyInstalledSkillRecord = InstalledSkillRecordBase;
+export interface SkillLocalRegistrationEntry {
+    skillName: string;
+    entryId: string;
+    location: string;
+}
+export interface SkillSearchResult {
+    skillName: string;
+    description: string;
+    source: SkillSource;
+    sourceLabel: string;
+    matchMethod: SkillMatchMethod;
+    reviewStatus: SkillReviewStatus;
+    installable: boolean;
+    notInstallableReason?: string;
+    latestRevision: string | null;
+    manifest?: SkillManifest;
+}
+export interface SkillPublishRequest {
+    manifest: SkillManifest;
+    repositoryPath: string;
+    pushDirectory: string;
+    branchName: string;
+    targetBranch: string;
+    commitMessage: string;
+    mergeRequestTitle: string;
+    mergeRequestDescription: string;
+    authorName: string;
+    authorEmail: string;
+    /** Absolute local path to manifest JSON (required for GitLab file upload). */
+    manifestPath?: string;
+}
+export interface SkillPublishPushResult {
+    repositoryPath: string;
+    branchName: string;
+    pushDirectory: string;
+}
+export interface SkillPublishMergeRequest {
+    id: string;
+    webUrl?: string;
+    title: string;
+    description: string;
+    branchName: string;
+    targetBranch: string;
+}
+export interface SkillPublishApprovalWebhookPayload {
+    channel: 'dingtalk';
+    repositoryPath: string;
+    pushDirectory: string;
+    branchName: string;
+    targetBranch: string;
+    mergeRequestId: string;
+    mergeRequestUrl?: string;
+    skillName: string;
+    skillVersion: string;
+    authorName: string;
+    authorEmail: string;
+    requestedAt: string;
+}
+export interface SkillPublishApprovalResult {
+    required: boolean;
+    webhookPayload?: SkillPublishApprovalWebhookPayload;
+    webhookStatus?: 'sent' | 'failed';
+    webhookError?: string;
+}
+export interface SkillPublishResult {
+    repositoryPath: string;
+    mergeRequest: SkillPublishMergeRequest;
+    approval?: SkillPublishApprovalResult;
+}
+export type SkillUpdateAction = 'auto-merge' | 'view-diff' | 'keep-local';
+export interface SkillUpdatePlan {
+    skillName: string;
+    currentRevision: string | null;
+    targetRevision: string;
+    action: SkillUpdateAction;
+    hasConflicts: boolean;
+    conflictSummary?: string;
+}
+export interface ResolvedSkillPackage {
+    manifest: SkillManifest;
+    revision: string | null;
+    content: string;
+    sourceRef: string;
+}
+export type SkillInstallAction = 'create' | 'update' | 'skip';
+export interface SkillInstallPlan {
+    action: SkillInstallAction;
+    skillName: string;
+    targetPath: string;
+    reason: string;
+}
+export interface InternalSkillProvider {
+    resolveByName(name: string): Promise<ResolvedSkillPackage | null>;
+    search(query: string): Promise<SkillSearchResult[]>;
+}
+export interface ExternalSkillProvider {
+    search(query: string): Promise<SkillSearchResult[]>;
+}
+export interface ExternalSkillVettingResult {
+    reviewStatus: SkillReviewStatus;
+    installable: boolean;
+    reason?: string;
+}
+export interface ExternalSkillVettingProvider {
+    vet(result: SkillSearchResult): Promise<ExternalSkillVettingResult>;
+}
+export interface SkillPublishBackend {
+    prepare(request: SkillPublishRequest): Promise<SkillPublishResult>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,KAAK,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,YAAY,GAAG,KAAK,GAAG,aAAa,GAAG,SAAS,CAAC;AAC/F,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wGAAwG;IACxG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,oBAAqB,SAAQ,wBAAwB;IACpE,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,MAAM,0BAA0B,GAAG,wBAAwB,CAAC;AAElE,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,YAAY,EAAE,iBAAiB,CAAC;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,aAAa,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uBAAuB,EAAE,MAAM,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,UAAU,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,kCAAkC,CAAC;IACpD,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,wBAAwB,CAAC;IACvC,QAAQ,CAAC,EAAE,0BAA0B,CAAC;CACvC;AAED,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAClE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,iBAAiB,CAAC;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,GAAG,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACpE"}

package/dist/skills/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":""}

package/dist/skills/update.d.ts

@@ -0,0 +1,11 @@
+import type { SkillUpdatePlan } from './types.js';
+export interface PlanSkillUpdateOptions {
+    skillName: string;
+    currentRevision: string | null;
+    targetRevision: string;
+    baseContent: string;
+    localContent: string;
+    targetContent: string;
+}
+export declare function planSkillUpdate(options: PlanSkillUpdateOptions): SkillUpdatePlan;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/skills/update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAiBD,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CA8ChF"}

package/dist/skills/update.js

@@ -0,0 +1,55 @@
+function countChangedLines(baseContent, nextContent) {
+    const baseLines = baseContent.split('\n');
+    const nextLines = nextContent.split('\n');
+    const maxLength = Math.max(baseLines.length, nextLines.length);
+    let changed = 0;
+    for (let index = 0; index < maxLength; index += 1) {
+        if ((baseLines[index] ?? '') !== (nextLines[index] ?? '')) {
+            changed += 1;
+        }
+    }
+    return changed;
+}
+export function planSkillUpdate(options) {
+    const normalizedSkillName = options.skillName.trim();
+    const localChanged = options.localContent !== options.baseContent;
+    const targetChanged = options.targetContent !== options.baseContent;
+    if (!localChanged) {
+        return {
+            skillName: normalizedSkillName,
+            currentRevision: options.currentRevision,
+            targetRevision: options.targetRevision,
+            action: 'auto-merge',
+            hasConflicts: false,
+        };
+    }
+    if (!targetChanged) {
+        return {
+            skillName: normalizedSkillName,
+            currentRevision: options.currentRevision,
+            targetRevision: options.targetRevision,
+            action: 'keep-local',
+            hasConflicts: false,
+        };
+    }
+    if (options.localContent === options.targetContent) {
+        return {
+            skillName: normalizedSkillName,
+            currentRevision: options.currentRevision,
+            targetRevision: options.targetRevision,
+            action: 'auto-merge',
+            hasConflicts: false,
+        };
+    }
+    const localChangedLines = countChangedLines(options.baseContent, options.localContent);
+    const targetChangedLines = countChangedLines(options.baseContent, options.targetContent);
+    return {
+        skillName: normalizedSkillName,
+        currentRevision: options.currentRevision,
+        targetRevision: options.targetRevision,
+        action: 'view-diff',
+        hasConflicts: true,
+        conflictSummary: `Conflict detected: both local and target revisions changed (${localChangedLines} local lines, ${targetChangedLines} target lines).`,
+    };
+}
+//# sourceMappingURL=update.js.map

package/dist/skills/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/skills/update.ts"],"names":[],"mappings":"AAWA,SAAS,iBAAiB,CAAC,WAAmB,EAAE,WAAmB;IACjE,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAE/D,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC1D,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,MAAM,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IACrD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC;IAClE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,KAAK,OAAO,CAAC,WAAW,CAAC;IAEpE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO;YACL,SAAS,EAAE,mBAAmB;YAC9B,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,MAAM,EAAE,YAAY;YACpB,YAAY,EAAE,KAAK;SACpB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO;YACL,SAAS,EAAE,mBAAmB;YAC9B,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,MAAM,EAAE,YAAY;YACpB,YAAY,EAAE,KAAK;SACpB,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC;QACnD,OAAO;YACL,SAAS,EAAE,mBAAmB;YAC9B,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,MAAM,EAAE,YAAY;YACpB,YAAY,EAAE,KAAK;SACpB,CAAC;IACJ,CAAC;IAED,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACvF,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAEzF,OAAO;QACL,SAAS,EAAE,mBAAmB;QAC9B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,MAAM,EAAE,WAAW;QACnB,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,+DAA+D,iBAAiB,iBAAiB,kBAAkB,iBAAiB;KACtJ,CAAC;AACJ,CAAC"}

package/dist/spec/command.d.ts

@@ -0,0 +1,11 @@
+import type { HarnessConfig } from '../contracts/config.js';
+import type { CommandRouter } from '../kernel/router.js';
+declare function renderSpecHelp(programName?: string): string;
+export declare function runSpecCommand(args: string[], context?: {
+    harnessConfig?: Pick<HarnessConfig, 'specMountPath'>;
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+}): Promise<number>;
+export declare function registerSpecCommand(router: CommandRouter): void;
+export { renderSpecHelp };
+//# sourceMappingURL=command.d.ts.map

package/dist/spec/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/spec/command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAczD,iBAAS,cAAc,CAAC,WAAW,SAAY,GAAG,MAAM,CAkBvD;AA8CD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GACjH,OAAO,CAAC,MAAM,CAAC,CA4IjB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAE/D;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}