@pellux/goodvibes-sdk 0.18.13 → 0.18.15

package/dist/_internal/platform/runtime/ecosystem/catalog.d.ts

@@ -0,0 +1,164 @@
+export type EcosystemEntryKind = 'plugin' | 'skill' | 'hook-pack' | 'policy-pack';
+export interface EcosystemCatalogPathOptions {
+    readonly cwd: string;
+    readonly homeDir: string;
+}
+export interface EcosystemCatalogEntry {
+    readonly id: string;
+    readonly kind: EcosystemEntryKind;
+    readonly name: string;
+    readonly summary: string;
+    readonly version?: string;
+    readonly author?: string;
+    readonly source: string;
+    readonly tags: readonly string[];
+    readonly trustNotes?: string;
+    readonly installHint?: string;
+    readonly provenance?: string;
+    readonly signature?: string;
+    readonly updateHint?: string;
+    readonly compatibility?: {
+        readonly minAppVersion?: string;
+        readonly maxAppVersion?: string;
+        readonly platforms?: readonly string[];
+        readonly requiresSandbox?: boolean;
+    };
+}
+export interface EcosystemCatalogFile {
+    readonly version: 1;
+    readonly entries: EcosystemCatalogEntry[];
+}
+export interface EcosystemInstallReceipt {
+    readonly version: 1;
+    readonly id: string;
+    readonly kind: EcosystemEntryKind;
+    readonly installedAt: number;
+    readonly scope: 'project' | 'user';
+    readonly entry: EcosystemCatalogEntry;
+    readonly sourcePath: string;
+    readonly targetPath: string;
+    readonly fingerprint: string;
+    readonly provenanceSummary: string;
+    readonly compatibility: {
+        readonly appVersion: string;
+        readonly status: 'compatible' | 'warning';
+        readonly reasons: readonly string[];
+    };
+}
+export interface EcosystemCatalogBundle {
+    readonly version: 1;
+    readonly exportedAt: number;
+    readonly scope: 'project' | 'user';
+    readonly entries: readonly EcosystemCatalogEntry[];
+}
+export interface EcosystemCatalogBundleSummary {
+    readonly exportedAt: number;
+    readonly scope: 'project' | 'user';
+    readonly counts: Readonly<Record<EcosystemEntryKind, number>>;
+}
+export interface EcosystemInstallBackup {
+    readonly version: 1;
+    readonly id: string;
+    readonly kind: EcosystemEntryKind;
+    readonly createdAt: number;
+    readonly scope: 'project' | 'user';
+    readonly archivedTargetPath: string;
+    readonly targetPath: string;
+    readonly receipt: EcosystemInstallReceipt;
+    readonly reason: 'update' | 'uninstall' | 'replace';
+}
+export declare function loadEcosystemCatalog(kind: EcosystemEntryKind, options: EcosystemCatalogPathOptions): EcosystemCatalogEntry[];
+export declare function searchEcosystemCatalog(kind: EcosystemEntryKind, query: string, options: EcosystemCatalogPathOptions): EcosystemCatalogEntry[];
+export declare function reviewEcosystemCatalogEntry(entry: EcosystemCatalogEntry, options: EcosystemCatalogPathOptions): {
+    entry: EcosystemCatalogEntry;
+    sourcePath: string;
+    sourceExists: boolean;
+    sourceKind: 'local-path' | 'remote' | 'unknown';
+    riskLevel: 'low' | 'medium';
+    recommendedScope: 'project' | 'user';
+    compatibility: {
+        status: 'compatible' | 'warning';
+        reasons: readonly string[];
+    };
+};
+export declare function installEcosystemCatalogEntry(kind: EcosystemEntryKind, entryId: string, options: EcosystemCatalogPathOptions & {
+    scope?: 'project' | 'user';
+    skipBackup?: boolean;
+}): {
+    ok: true;
+    receipt: EcosystemInstallReceipt;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function inspectInstalledEcosystemEntry(kind: EcosystemEntryKind, entryId: string, options: EcosystemCatalogPathOptions & {
+    scope?: 'project' | 'user';
+}): {
+    ok: true;
+    receipt: EcosystemInstallReceipt;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function uninstallEcosystemCatalogEntry(kind: EcosystemEntryKind, entryId: string, options: EcosystemCatalogPathOptions & {
+    scope?: 'project' | 'user';
+}): {
+    ok: true;
+    removedPath: string;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function updateInstalledEcosystemEntry(kind: EcosystemEntryKind, entryId: string, options: EcosystemCatalogPathOptions & {
+    scope?: 'project' | 'user';
+}): {
+    ok: true;
+    receipt: EcosystemInstallReceipt;
+    previousReceipt: EcosystemInstallReceipt;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function listEcosystemInstallBackups(kind: EcosystemEntryKind, entryId: string, options: EcosystemCatalogPathOptions & {
+    scope?: 'project' | 'user';
+}): EcosystemInstallBackup[];
+export declare function rollbackInstalledEcosystemEntry(kind: EcosystemEntryKind, entryId: string, options: EcosystemCatalogPathOptions & {
+    scope?: 'project' | 'user';
+    backupId?: string;
+}): {
+    ok: true;
+    receipt: EcosystemInstallReceipt;
+    restoredFrom: EcosystemInstallBackup;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function listInstalledEcosystemEntries(kind: EcosystemEntryKind, options: EcosystemCatalogPathOptions): EcosystemInstallReceipt[];
+export declare function exportEcosystemCatalogBundle(scope: 'project' | 'user', options: EcosystemCatalogPathOptions): EcosystemCatalogBundle;
+export declare function inspectEcosystemCatalogBundle(bundle: EcosystemCatalogBundle): EcosystemCatalogBundleSummary;
+export declare function importEcosystemCatalogBundle(bundle: EcosystemCatalogBundle, options: EcosystemCatalogPathOptions & {
+    scope?: 'project' | 'user';
+}): {
+    imported: number;
+    pathByKind: Partial<Record<EcosystemEntryKind, string>>;
+};
+export declare function upsertEcosystemCatalogEntry(entry: EcosystemCatalogEntry, options: EcosystemCatalogPathOptions & {
+    scope?: 'project' | 'user';
+}): {
+    ok: true;
+    path: string;
+    entry: EcosystemCatalogEntry;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function removeEcosystemCatalogEntry(kind: EcosystemEntryKind, entryId: string, options: EcosystemCatalogPathOptions & {
+    scope?: 'project' | 'user';
+}): {
+    ok: true;
+    path: string;
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=catalog.d.ts.map

package/dist/_internal/platform/runtime/ecosystem/catalog.d.ts.map

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

package/dist/_internal/platform/runtime/ecosystem/catalog.js

@@ -0,0 +1,445 @@
+import { createHash } from 'node:crypto';
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { VERSION } from '../../version.js';
+function catalogPath(kind, cwd, homeDir, scope) {
+    return scope === 'project'
+        ? join(cwd, '.goodvibes', 'goodvibes', 'ecosystem', `${kind}s.json`)
+        : join(homeDir, '.goodvibes', 'goodvibes', 'ecosystem', `${kind}s.json`);
+}
+function catalogPaths(kind, cwd, homeDir) {
+    return [
+        join(cwd, '.goodvibes', 'goodvibes', 'ecosystem', `${kind}s.json`),
+        join(homeDir, '.goodvibes', 'goodvibes', 'ecosystem', `${kind}s.json`),
+    ];
+}
+function installedRoot(kind, cwd, homeDir, scope) {
+    const base = scope === 'project'
+        ? join(cwd, '.goodvibes')
+        : join(homeDir, '.goodvibes');
+    switch (kind) {
+        case 'plugin':
+            return join(base, 'plugins');
+        case 'skill':
+            return join(base, 'skills');
+        case 'hook-pack':
+            return join(base, 'hooks', 'packs');
+        case 'policy-pack':
+            return join(base, 'policies', 'packs');
+    }
+}
+function installedReceiptsRoot(cwd, homeDir, scope) {
+    return scope === 'project'
+        ? join(cwd, '.goodvibes', 'goodvibes', 'ecosystem', 'installed')
+        : join(homeDir, '.goodvibes', 'goodvibes', 'ecosystem', 'installed');
+}
+function receiptPath(kind, entryId, cwd, homeDir, scope) {
+    const base = installedReceiptsRoot(cwd, homeDir, scope);
+    return join(base, `${kind}-${entryId}.json`);
+}
+function backupRoot(cwd, homeDir, scope) {
+    return join(installedReceiptsRoot(cwd, homeDir, scope), 'backups');
+}
+function backupPrefix(kind, entryId) {
+    return `${kind}-${entryId}`;
+}
+function backupMetaPath(kind, entryId, createdAt, cwd, homeDir, scope) {
+    return join(backupRoot(cwd, homeDir, scope), `${backupPrefix(kind, entryId)}-${createdAt}.json`);
+}
+function backupArchivePath(kind, entryId, createdAt, cwd, homeDir, scope) {
+    return join(backupRoot(cwd, homeDir, scope), `${backupPrefix(kind, entryId)}-${createdAt}`);
+}
+function loadReceipt(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        return parsed?.version === 1 ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function loadBackup(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        return parsed?.version === 1 ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function createBackupFromReceipt(receipt, reason, cwd, homeDir) {
+    const createdAt = Date.now();
+    const archivedTargetPath = backupArchivePath(receipt.kind, receipt.entry.id, createdAt, cwd, homeDir, receipt.scope);
+    mkdirSync(dirname(archivedTargetPath), { recursive: true });
+    rmSync(archivedTargetPath, { recursive: true, force: true });
+    if (existsSync(receipt.targetPath)) {
+        cpSync(receipt.targetPath, archivedTargetPath, { recursive: true });
+    }
+    else {
+        mkdirSync(archivedTargetPath, { recursive: true });
+    }
+    const backup = {
+        version: 1,
+        id: `${receipt.kind}:${receipt.entry.id}:${createdAt}`,
+        kind: receipt.kind,
+        createdAt,
+        scope: receipt.scope,
+        archivedTargetPath,
+        targetPath: receipt.targetPath,
+        receipt,
+        reason,
+    };
+    const metaPath = backupMetaPath(receipt.kind, receipt.entry.id, createdAt, cwd, homeDir, receipt.scope);
+    writeFileSync(metaPath, `${JSON.stringify(backup, null, 2)}\n`, 'utf-8');
+    return backup;
+}
+function parseVersionParts(value) {
+    return value
+        .split('.')
+        .map((part) => parseInt(part.replace(/[^0-9].*$/, ''), 10))
+        .map((part) => (Number.isFinite(part) ? part : 0));
+}
+function compareVersions(a, b) {
+    const left = parseVersionParts(a);
+    const right = parseVersionParts(b);
+    const length = Math.max(left.length, right.length);
+    for (let index = 0; index < length; index++) {
+        const l = left[index] ?? 0;
+        const r = right[index] ?? 0;
+        if (l > r)
+            return 1;
+        if (l < r)
+            return -1;
+    }
+    return 0;
+}
+function hashPath(path) {
+    const hash = createHash('sha256');
+    if (!existsSync(path)) {
+        hash.update(`missing:${path}`);
+        return hash.digest('hex');
+    }
+    const stat = statSync(path);
+    if (stat.isDirectory()) {
+        const names = readdirSync(path).sort((a, b) => a.localeCompare(b));
+        hash.update(`dir:${path}`);
+        for (const name of names) {
+            hash.update(name);
+            hash.update(hashPath(join(path, name)));
+        }
+        return hash.digest('hex');
+    }
+    hash.update(`file:${path}`);
+    hash.update(readFileSync(path));
+    return hash.digest('hex');
+}
+function readCatalogFile(path) {
+    if (!existsSync(path))
+        return [];
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        if (!parsed || parsed.version !== 1 || !Array.isArray(parsed.entries))
+            return [];
+        return parsed.entries.filter((entry) => entry && typeof entry.id === 'string' && typeof entry.name === 'string' && entry.kind !== undefined);
+    }
+    catch {
+        return [];
+    }
+}
+function readCatalogDocument(path) {
+    if (!existsSync(path))
+        return { version: 1, entries: [] };
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        if (!parsed || parsed.version !== 1 || !Array.isArray(parsed.entries)) {
+            return { version: 1, entries: [] };
+        }
+        return {
+            version: 1,
+            entries: parsed.entries.filter((entry) => entry && typeof entry.id === 'string' && typeof entry.name === 'string' && entry.kind !== undefined),
+        };
+    }
+    catch {
+        return { version: 1, entries: [] };
+    }
+}
+export function loadEcosystemCatalog(kind, options) {
+    const { cwd, homeDir } = options;
+    const seen = new Set();
+    const entries = [];
+    for (const path of catalogPaths(kind, cwd, homeDir)) {
+        for (const entry of readCatalogFile(path)) {
+            if (entry.kind !== kind)
+                continue;
+            if (seen.has(entry.id))
+                continue;
+            seen.add(entry.id);
+            entries.push(entry);
+        }
+    }
+    return entries.sort((a, b) => a.name.localeCompare(b.name));
+}
+export function searchEcosystemCatalog(kind, query, options) {
+    const normalized = query.trim().toLowerCase();
+    const entries = loadEcosystemCatalog(kind, options);
+    if (!normalized)
+        return entries;
+    return entries.filter((entry) => {
+        const haystack = [
+            entry.id,
+            entry.name,
+            entry.summary,
+            entry.source,
+            entry.trustNotes ?? '',
+            entry.installHint ?? '',
+            ...entry.tags,
+        ].join(' ').toLowerCase();
+        return haystack.includes(normalized);
+    });
+}
+export function reviewEcosystemCatalogEntry(entry, options) {
+    const { cwd, homeDir } = options;
+    const sourcePath = entry.source.startsWith('/') || entry.source.startsWith('.')
+        ? resolve(cwd, entry.source)
+        : resolve(homeDir, entry.source);
+    const sourceExists = existsSync(sourcePath);
+    const sourceKind = entry.source.startsWith('/') || entry.source.startsWith('.')
+        ? 'local-path'
+        : entry.source.includes('://') || entry.source.startsWith('git+') || entry.source.startsWith('repo:')
+            ? 'remote'
+            : 'unknown';
+    const reasons = [];
+    if (entry.compatibility?.minAppVersion && compareVersions(VERSION, entry.compatibility.minAppVersion) < 0) {
+        reasons.push(`requires GoodVibes >= ${entry.compatibility.minAppVersion}`);
+    }
+    if (entry.compatibility?.maxAppVersion && compareVersions(VERSION, entry.compatibility.maxAppVersion) > 0) {
+        reasons.push(`targets GoodVibes <= ${entry.compatibility.maxAppVersion}`);
+    }
+    if (entry.compatibility?.platforms && entry.compatibility.platforms.length > 0 && !entry.compatibility.platforms.includes(process.platform)) {
+        reasons.push(`targets platforms: ${entry.compatibility.platforms.join(', ')}`);
+    }
+    if (entry.compatibility?.requiresSandbox) {
+        reasons.push('requires sandbox-backed execution support');
+    }
+    return {
+        entry,
+        sourcePath,
+        sourceExists,
+        sourceKind,
+        riskLevel: entry.trustNotes || sourceKind === 'remote' ? 'medium' : 'low',
+        recommendedScope: entry.kind === 'plugin' ? 'project' : 'user',
+        compatibility: {
+            status: reasons.length > 0 ? 'warning' : 'compatible',
+            reasons,
+        },
+    };
+}
+export function installEcosystemCatalogEntry(kind, entryId, options) {
+    const { cwd, homeDir } = options;
+    const scope = options.scope ?? 'project';
+    const entry = loadEcosystemCatalog(kind, { cwd, homeDir }).find((candidate) => candidate.id === entryId);
+    if (!entry)
+        return { ok: false, error: `Unknown curated ${kind} entry: ${entryId}` };
+    const review = reviewEcosystemCatalogEntry(entry, { cwd, homeDir });
+    if (review.sourceKind !== 'local-path') {
+        return { ok: false, error: `Curated ${kind} entry ${entryId} is not a local path source and cannot be installed directly.` };
+    }
+    if (!review.sourceExists) {
+        return { ok: false, error: `Curated ${kind} source path does not exist: ${review.sourcePath}` };
+    }
+    const targetPath = join(installedRoot(kind, cwd, homeDir, scope), entry.id);
+    const previousReceipt = loadReceipt(receiptPath(kind, entry.id, cwd, homeDir, scope));
+    if (previousReceipt && !options.skipBackup) {
+        createBackupFromReceipt(previousReceipt, 'replace', cwd, homeDir);
+    }
+    mkdirSync(installedRoot(kind, cwd, homeDir, scope), { recursive: true });
+    rmSync(targetPath, { recursive: true, force: true });
+    cpSync(review.sourcePath, targetPath, { recursive: true });
+    const receipt = {
+        version: 1,
+        id: `${kind}:${entry.id}`,
+        kind,
+        installedAt: Date.now(),
+        scope,
+        entry,
+        sourcePath: review.sourcePath,
+        targetPath,
+        fingerprint: hashPath(targetPath),
+        provenanceSummary: entry.provenance ?? entry.source,
+        compatibility: {
+            appVersion: VERSION,
+            status: review.compatibility.status,
+            reasons: review.compatibility.reasons,
+        },
+    };
+    const path = receiptPath(kind, entry.id, cwd, homeDir, scope);
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(receipt, null, 2)}\n`, 'utf-8');
+    return { ok: true, receipt };
+}
+export function inspectInstalledEcosystemEntry(kind, entryId, options) {
+    const { cwd, homeDir } = options;
+    const scope = options.scope ?? 'project';
+    const receipt = loadReceipt(receiptPath(kind, entryId, cwd, homeDir, scope));
+    if (!receipt) {
+        return { ok: false, error: `No installed ${kind} receipt found for ${entryId} in ${scope} scope.` };
+    }
+    return { ok: true, receipt };
+}
+export function uninstallEcosystemCatalogEntry(kind, entryId, options) {
+    const { cwd, homeDir } = options;
+    const scope = options.scope ?? 'project';
+    const receipt = loadReceipt(receiptPath(kind, entryId, cwd, homeDir, scope));
+    if (!receipt)
+        return { ok: false, error: `No installed ${kind} receipt found for ${entryId} in ${scope} scope.` };
+    createBackupFromReceipt(receipt, 'uninstall', cwd, homeDir);
+    rmSync(receipt.targetPath, { recursive: true, force: true });
+    rmSync(receiptPath(kind, entryId, cwd, homeDir, scope), { force: true });
+    return { ok: true, removedPath: receipt.targetPath };
+}
+export function updateInstalledEcosystemEntry(kind, entryId, options) {
+    const { cwd, homeDir } = options;
+    const scope = options.scope ?? 'project';
+    const previousReceipt = loadReceipt(receiptPath(kind, entryId, cwd, homeDir, scope));
+    if (!previousReceipt) {
+        return { ok: false, error: `No installed ${kind} receipt found for ${entryId} in ${scope} scope.` };
+    }
+    createBackupFromReceipt(previousReceipt, 'update', cwd, homeDir);
+    const installed = installEcosystemCatalogEntry(kind, entryId, { cwd, homeDir, scope, skipBackup: true });
+    if (!installed.ok)
+        return installed;
+    return { ok: true, receipt: installed.receipt, previousReceipt };
+}
+export function listEcosystemInstallBackups(kind, entryId, options) {
+    const { cwd, homeDir } = options;
+    const scope = options.scope ?? 'project';
+    const dir = backupRoot(cwd, homeDir, scope);
+    if (!existsSync(dir))
+        return [];
+    const prefix = `${backupPrefix(kind, entryId)}-`;
+    return readdirSync(dir)
+        .filter((name) => name.startsWith(prefix) && name.endsWith('.json'))
+        .map((name) => loadBackup(join(dir, name)))
+        .filter((backup) => backup !== null && backup.kind === kind && backup.receipt.entry.id === entryId)
+        .sort((a, b) => b.createdAt - a.createdAt);
+}
+export function rollbackInstalledEcosystemEntry(kind, entryId, options) {
+    const { cwd, homeDir } = options;
+    const scope = options.scope ?? 'project';
+    const backups = listEcosystemInstallBackups(kind, entryId, { cwd, homeDir, scope });
+    const backup = options.backupId
+        ? backups.find((candidate) => candidate.id === options.backupId)
+        : backups[0];
+    if (!backup) {
+        return { ok: false, error: `No rollback backup found for ${kind} ${entryId} in ${scope} scope.` };
+    }
+    mkdirSync(dirname(backup.targetPath), { recursive: true });
+    rmSync(backup.targetPath, { recursive: true, force: true });
+    cpSync(backup.archivedTargetPath, backup.targetPath, { recursive: true });
+    writeFileSync(receiptPath(kind, entryId, cwd, homeDir, scope), `${JSON.stringify(backup.receipt, null, 2)}\n`, 'utf-8');
+    return { ok: true, receipt: backup.receipt, restoredFrom: backup };
+}
+export function listInstalledEcosystemEntries(kind, options) {
+    const { cwd, homeDir } = options;
+    const receipts = [
+        installedReceiptsRoot(cwd, homeDir, 'project'),
+        installedReceiptsRoot(cwd, homeDir, 'user'),
+    ];
+    const found = [];
+    for (const dir of receipts) {
+        if (!existsSync(dir))
+            continue;
+        for (const name of readdirSync(dir)) {
+            if (!name.startsWith(`${kind}-`) || !name.endsWith('.json'))
+                continue;
+            const receipt = loadReceipt(join(dir, name));
+            if (receipt && receipt.kind === kind)
+                found.push(receipt);
+        }
+    }
+    return found.sort((a, b) => b.installedAt - a.installedAt);
+}
+export function exportEcosystemCatalogBundle(scope, options) {
+    const { cwd, homeDir } = options;
+    const paths = {
+        plugin: catalogPath('plugin', cwd, homeDir, scope),
+        skill: catalogPath('skill', cwd, homeDir, scope),
+        'hook-pack': catalogPath('hook-pack', cwd, homeDir, scope),
+        'policy-pack': catalogPath('policy-pack', cwd, homeDir, scope),
+    };
+    return {
+        version: 1,
+        exportedAt: Date.now(),
+        scope,
+        entries: [
+            ...readCatalogFile(paths.plugin).filter((entry) => entry.kind === 'plugin'),
+            ...readCatalogFile(paths.skill).filter((entry) => entry.kind === 'skill'),
+            ...readCatalogFile(paths['hook-pack']).filter((entry) => entry.kind === 'hook-pack'),
+            ...readCatalogFile(paths['policy-pack']).filter((entry) => entry.kind === 'policy-pack'),
+        ].sort((a, b) => a.name.localeCompare(b.name)),
+    };
+}
+export function inspectEcosystemCatalogBundle(bundle) {
+    const counts = { plugin: 0, skill: 0, 'hook-pack': 0, 'policy-pack': 0 };
+    for (const entry of bundle.entries) {
+        counts[entry.kind] += 1;
+    }
+    return {
+        exportedAt: bundle.exportedAt,
+        scope: bundle.scope,
+        counts,
+    };
+}
+export function importEcosystemCatalogBundle(bundle, options) {
+    const scope = options.scope ?? bundle.scope;
+    const byKind = {
+        plugin: [],
+        skill: [],
+        'hook-pack': [],
+        'policy-pack': [],
+    };
+    for (const entry of bundle.entries) {
+        byKind[entry.kind].push(entry);
+    }
+    const pathByKind = {};
+    let imported = 0;
+    for (const kind of ['plugin', 'skill', 'hook-pack', 'policy-pack']) {
+        if (byKind[kind].length === 0)
+            continue;
+        const path = catalogPath(kind, options.cwd, options.homeDir, scope);
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, `${JSON.stringify({ version: 1, entries: byKind[kind].sort((a, b) => a.name.localeCompare(b.name)) }, null, 2)}\n`, 'utf-8');
+        pathByKind[kind] = path;
+        imported += byKind[kind].length;
+    }
+    return { imported, pathByKind };
+}
+export function upsertEcosystemCatalogEntry(entry, options) {
+    const { cwd, homeDir } = options;
+    const scope = options.scope ?? 'project';
+    const path = catalogPath(entry.kind, cwd, homeDir, scope);
+    const document = readCatalogDocument(path);
+    const nextEntries = document.entries.filter((candidate) => candidate.id !== entry.id || candidate.kind !== entry.kind);
+    nextEntries.push(entry);
+    nextEntries.sort((a, b) => a.name.localeCompare(b.name));
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify({ version: 1, entries: nextEntries }, null, 2)}\n`, 'utf-8');
+    return { ok: true, path, entry };
+}
+export function removeEcosystemCatalogEntry(kind, entryId, options) {
+    const { cwd, homeDir } = options;
+    const scope = options.scope ?? 'project';
+    const path = catalogPath(kind, cwd, homeDir, scope);
+    const document = readCatalogDocument(path);
+    const nextEntries = document.entries.filter((candidate) => candidate.id !== entryId || candidate.kind !== kind);
+    if (nextEntries.length === document.entries.length) {
+        return { ok: false, error: `Curated ${kind} catalog entry not found: ${entryId}` };
+    }
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify({ version: 1, entries: nextEntries }, null, 2)}\n`, 'utf-8');
+    return { ok: true, path };
+}

package/dist/_internal/platform/runtime/ecosystem/recommendations.d.ts

@@ -0,0 +1,12 @@
+import type { RuntimeStore } from '../store/index.js';
+import { type EcosystemCatalogPathOptions, type EcosystemCatalogEntry, type EcosystemEntryKind } from './catalog.js';
+export interface EcosystemRecommendation {
+    readonly id: string;
+    readonly title: string;
+    readonly reason: string;
+    readonly kind: EcosystemEntryKind;
+    readonly entry: EcosystemCatalogEntry;
+    readonly command: string;
+}
+export declare function buildEcosystemRecommendations(runtimeStore: RuntimeStore | undefined, options: EcosystemCatalogPathOptions): EcosystemRecommendation[];
+//# sourceMappingURL=recommendations.d.ts.map

package/dist/_internal/platform/runtime/ecosystem/recommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/ecosystem/recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACL,KAAK,2BAA2B,EAGhC,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAoCD,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,YAAY,GAAG,SAAS,EACtC,OAAO,EAAE,2BAA2B,GACnC,uBAAuB,EAAE,CA6D3B"}