@adea-ai/plugins 4.0.0 → 4.0.6

package/dist/artifacts.js

@@ -0,0 +1,159 @@
+import { publishCatalog } from './catalog-store.js';
+import { buildConsumerIndex, CATALOG_INDEX_ARTIFACT, iconCoverage, } from './consumer-index.js';
+import { digest } from './digest.js';
+import { publishedAssetOf } from './integrity-manifest.js';
+import { catalogIdSuffix, immutableAssetUrl } from './publication.js';
+export function createArtifacts(catalog, lock, options = {}) {
+    const index = buildConsumerIndex({ ...options, catalog });
+    const summary = {
+        schemaVersion: 1,
+        catalogId: catalog.catalogId,
+        generatedAt: catalog.generatedAt,
+        sourceCount: catalog.sources.length,
+        pluginCount: catalog.plugins.length,
+        categories: [...new Set(catalog.plugins.flatMap((plugin) => plugin.categories))].toSorted(),
+        productGroups: [
+            ...new Set(catalog.plugins.map((plugin) => plugin.productGroupingKey)),
+        ].toSorted(),
+        search: catalog.plugins
+            .map((plugin) => ({
+            pluginId: plugin.pluginId,
+            text: `${plugin.displayName} ${plugin.description} ${plugin.keywords.join(' ')}`.trim(),
+        }))
+            .toSorted((left, right) => left.pluginId.localeCompare(right.pluginId)),
+    };
+    const compatibility = {
+        schemaVersion: 1,
+        catalogId: catalog.catalogId,
+        plugins: catalog.plugins.map((plugin) => ({
+            pluginId: plugin.pluginId,
+            harnessCompatibility: plugin.harnessCompatibility,
+        })),
+    };
+    // Navigation stays small and points at the shards a client then fetches:
+    // `shelf-*` for a default view, `category-*` for "view more", and
+    // `catalog-index.v1.json` for the complete product list.
+    const navigation = {
+        schemaVersion: 1,
+        catalogId: catalog.catalogId,
+        generatedAt: catalog.generatedAt,
+        topCount: index.topCount,
+        sourcePreference: index.sourcePreference,
+        counts: index.counts,
+        catalogIndexArtifact: CATALOG_INDEX_ARTIFACT,
+        iconCoverage: iconCoverage(index),
+        // The index URL rides in the navigation artifact so a client can fetch the
+        // browsing index from the publication it was told about, verify it against
+        // the digest in integrity.json, and never compose a URL or need this
+        // service to proxy it. Absent for an unpublished build.
+        ...(options.publicationCatalogsBaseUrl
+            ? {
+                catalogIndexUrl: `${options.publicationCatalogsBaseUrl}/${catalogIdSuffix(catalog.catalogId)}/${CATALOG_INDEX_ARTIFACT}`,
+            }
+            : options.publicationAssetsBaseUrl
+                ? { catalogIndexUrl: `${options.publicationAssetsBaseUrl}/${CATALOG_INDEX_ARTIFACT}` }
+                : options.publicationRepositoryUrl
+                    ? {
+                        catalogIndexUrl: immutableAssetUrl(options.publicationRepositoryUrl, catalog.catalogId, CATALOG_INDEX_ARTIFACT),
+                    }
+                    : {}),
+        // Marks ride in the navigation artifact so a client that already receives it
+        // renders compiled brand marks without fetching the browsing index. Keys are
+        // sorted for a stable artifact.
+        brandMarks: Object.fromEntries(Object.keys(index.products)
+            .toSorted()
+            .flatMap((productKey) => {
+            const assetUrl = index.products[productKey]?.icon?.assetUrl;
+            return assetUrl ? [[productKey, assetUrl]] : [];
+        })),
+        categories: index.categories,
+        diagnostics: options.curationDiagnostics === false ? [] : index.diagnostics,
+    };
+    const shards = {
+        [CATALOG_INDEX_ARTIFACT]: json({
+            schemaVersion: 1,
+            catalogId: catalog.catalogId,
+            generatedAt: catalog.generatedAt,
+            topCount: index.topCount,
+            sourcePreference: index.sourcePreference,
+            counts: index.counts,
+            products: index.products,
+            categories: index.categories.map((category) => ({
+                category: category.category,
+                productCount: category.productCount,
+                productKeys: category.productKeys,
+            })),
+        }),
+    };
+    for (const category of index.categories) {
+        shards[category.shelfArtifact] = json({
+            schemaVersion: 1,
+            catalogId: catalog.catalogId,
+            category: category.category,
+            topCount: index.topCount,
+            products: category.topProductKeys.map((productKey) => index.products[productKey]),
+        });
+        shards[category.listArtifact] = json({
+            schemaVersion: 1,
+            catalogId: catalog.catalogId,
+            category: category.category,
+            productCount: category.productCount,
+            pluginCount: category.pluginCount,
+            products: category.productKeys.map((productKey) => index.products[productKey]),
+        });
+    }
+    const files = {
+        'catalog.v1.json': json(catalog),
+        'catalog-summary.v1.json': json(summary),
+        'sources.lock.json': json(lock),
+        'compatibility.v1.json': json(compatibility),
+        'categories.v1.json': json(navigation),
+        ...shards,
+    };
+    const integrityBody = {
+        schemaVersion: 1,
+        catalogId: catalog.catalogId,
+        // An artifact's digest is the canonical digest of its text, not a hash of
+        // the file bytes: consumers read the artifact as a string and compare it
+        // with `canonicalDigest`, so a checker hashing the raw bytes will disagree
+        // with every published release. Mirrored marks below are the byte case,
+        // because a client stores those bytes.
+        files: Object.fromEntries(Object.entries(files)
+            .toSorted()
+            .map(([name, content]) => [name, digest(content)])),
+        // Mirrored brand marks are published next to the artifacts, never inside
+        // them: the digest and size let a consumer or the release check verify the
+        // bytes it fetched without trusting the release listing.
+        assets: iconAssets(index),
+    };
+    return { ...files, 'integrity.json': json(integrityBody) };
+}
+export function iconAssets(index) {
+    const assets = new Map();
+    for (const product of Object.values(index.products)) {
+        if (!product.icon)
+            continue;
+        assets.set(product.icon.asset, publishedAssetOf(product.icon));
+    }
+    return [...assets.values()].toSorted((left, right) => left.name.localeCompare(right.name));
+}
+/**
+ * Publishes a verified artifact set to `generatedDirectory` under the output's
+ * coordination lock. See `catalog-store.ts` for the publication contract.
+ */
+export async function writeArtifacts(generatedDirectory, artifacts, options = {}) {
+    await publishCatalog(generatedDirectory, artifacts, options);
+}
+function sortArtifactKeys(value) {
+    if (Array.isArray(value))
+        return value.map(sortArtifactKeys);
+    if (value !== null && typeof value === 'object')
+        return Object.fromEntries(Object.keys(value)
+            .toSorted()
+            .map((key) => [key, sortArtifactKeys(value[key])]));
+    return value;
+}
+function json(value) {
+    return `${JSON.stringify(sortArtifactKeys(value), null, 2)}\n`;
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,MAAM,oBAAoB,CAAA;AACxE,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,GAGb,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,gBAAgB,EAAuB,MAAM,yBAAyB,CAAA;AAC/E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAmDrE,MAAM,UAAU,eAAe,CAC7B,OAAgB,EAChB,IAAiB,EACjB,OAAO,GAAyB,EAAE;IAElC,MAAM,KAAK,GAAG,kBAAkB,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;IACzD,MAAM,OAAO,GAAG;QACd,aAAa,EAAE,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;QACnC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;QACnC,UAAU,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC3F,aAAa,EAAE;YACb,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;SACvE,CAAC,QAAQ,EAAE;QACZ,MAAM,EAAE,OAAO,CAAC,OAAO;aACpB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAChB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE;SACxF,CAAC,CAAC;aACF,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;KAC1E,CAAA;IACD,MAAM,aAAa,GAAG;QACpB,aAAa,EAAE,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;SAClD,CAAC,CAAC;KACJ,CAAA;IACD,yEAAyE;IACzE,kEAAkE;IAClE,yDAAyD;IACzD,MAAM,UAAU,GAAG;QACjB,aAAa,EAAE,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,oBAAoB,EAAE,sBAAsB;QAC5C,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC;QACjC,2EAA2E;QAC3E,2EAA2E;QAC3E,qEAAqE;QACrE,wDAAwD;QACxD,GAAG,CAAC,OAAO,CAAC,0BAA0B;YACpC,CAAC,CAAC;gBACE,eAAe,EAAE,GAAG,OAAO,CAAC,0BAA0B,IAAI,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,sBAAsB,EAAE;aACzH;YACH,CAAC,CAAC,OAAO,CAAC,wBAAwB;gBAChC,CAAC,CAAC,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,wBAAwB,IAAI,sBAAsB,EAAE,EAAE;gBACtF,CAAC,CAAC,OAAO,CAAC,wBAAwB;oBAChC,CAAC,CAAC;wBACE,eAAe,EAAE,iBAAiB,CAChC,OAAO,CAAC,wBAAwB,EAChC,OAAO,CAAC,SAAS,EACjB,sBAAsB,CACvB;qBACF;oBACH,CAAC,CAAC,EAAE,CAAC;QACX,6EAA6E;QAC7E,6EAA6E;QAC7E,gCAAgC;QAChC,UAAU,EAAE,MAAM,CAAC,WAAW,CAC5B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;aACxB,QAAQ,EAAE;aACV,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;YACtB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAA;YAC3D,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC1D,CAAC,CAAC,CACL;QACD,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,WAAW,EAAE,OAAO,CAAC,mBAAmB,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW;KAC5E,CAAA;IACD,MAAM,MAAM,GAA2B;QACrC,CAAC,sBAAsB,CAAC,EAAE,IAAI,CAAC;YAC7B,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBAC9C,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,YAAY,EAAE,QAAQ,CAAC,YAAY;gBACnC,WAAW,EAAE,QAAQ,CAAC,WAAW;aAClC,CAAC,CAAC;SACJ,CAAC;KACH,CAAA;IACD,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACxC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;YACpC,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;SAClF,CAAC,CAAA;QACF,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;YACnC,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;SAC/E,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,KAAK,GAA2B;QACpC,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC;QAChC,yBAAyB,EAAE,IAAI,CAAC,OAAO,CAAC;QACxC,mBAAmB,EAAE,IAAI,CAAC,IAAI,CAAC;QAC/B,uBAAuB,EAAE,IAAI,CAAC,aAAa,CAAC;QAC5C,oBAAoB,EAAE,IAAI,CAAC,UAAU,CAAC;QACtC,GAAG,MAAM;KACV,CAAA;IACD,MAAM,aAAa,GAAG;QACpB,aAAa,EAAE,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,0EAA0E;QAC1E,yEAAyE;QACzE,2EAA2E;QAC3E,wEAAwE;QACxE,uCAAuC;QACvC,KAAK,EAAE,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;aAClB,QAAQ,EAAE;aACV,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CACrD;QACD,yEAAyE;QACzE,2EAA2E;QAC3E,yDAAyD;QACzD,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC;KAC1B,CAAA;IACD,OAAO,EAAE,GAAG,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,aAAa,CAAC,EAAwB,CAAA;AAClF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAoB;IAC7C,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAA;IAChD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,OAAO,CAAC,IAAI;YAAE,SAAQ;QAC3B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IAChE,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;AAC5F,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,kBAA0B,EAC1B,SAA6B,EAC7B,OAAO,GAAmB,EAAE;IAE5B,MAAM,cAAc,CAAC,kBAAkB,EAAE,SAAmC,EAAE,OAAO,CAAC,CAAA;AACxF,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAC5D,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAC7C,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC;aAC1C,QAAQ,EAAE;aACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,gBAAgB,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAClF,CAAA;IACH,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,IAAI,CAAC,KAAc;IAC1B,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAA;AAChE,CAAC"}

package/dist/build.d.ts

@@ -0,0 +1,20 @@
+import { type ReleaseOptions } from './plugin-release.js';
+import { type SkippedPlugin } from './plugin-skips.js';
+import { type CatalogPolicy } from './policy.js';
+import { type Catalog } from './schema.js';
+import type { ResolvedSource } from './source-resolution.js';
+export interface BuildCatalogInput extends Omit<ReleaseOptions, 'policy' | 'metadataOnly' | 'resolveExternalRefs'> {
+    readonly resolvedSources: readonly ResolvedSource[];
+    /** Each category's curated products, which head the catalog in this order. */
+    readonly leading?: Readonly<Record<string, readonly string[]>>;
+    readonly policy?: CatalogPolicy;
+    readonly metadataOnly?: boolean;
+    readonly resolveExternalRefs?: boolean;
+}
+interface BuildCatalogResult {
+    readonly catalog: Catalog;
+    readonly skippedPlugins: readonly SkippedPlugin[];
+}
+export declare function buildCatalog(input: BuildCatalogInput): Promise<Catalog>;
+export declare function buildCatalogInternal(input: BuildCatalogInput): Promise<BuildCatalogResult>;
+export {};

package/dist/build.js

@@ -0,0 +1,103 @@
+import { mapWithConcurrency } from './concurrency.js';
+import { contentId } from './digest.js';
+import { normalizePlugin } from './plugin-release.js';
+import { createSkippedPlugin, PluginSafetyError, UPSTREAM_WEATHER_SKIP_CODES, } from './plugin-skips.js';
+import { assertRepositoryAllowed, DEFAULT_POLICY } from './policy.js';
+import { CatalogSchema, PluginSchema, } from './schema.js';
+import { canonicalRepositoryUrl } from './sources.js';
+import { orderLeadingPlugins } from './taxonomy.js';
+export async function buildCatalog(input) {
+    return (await buildCatalogInternal(input)).catalog;
+}
+export async function buildCatalogInternal(input) {
+    const policy = input.policy ?? DEFAULT_POLICY;
+    const options = {
+        ...input,
+        policy,
+        metadataOnly: input.metadataOnly ?? false,
+        resolveExternalRefs: input.resolveExternalRefs ?? false,
+    };
+    for (const source of input.resolvedSources) {
+        assertRepositoryAllowed(source.config.repositoryUrl, policy);
+        for (const entry of source.parsed.entries) {
+            if (entry.source.kind === 'git')
+                assertRepositoryAllowed(entry.source.repositoryUrl, policy);
+        }
+    }
+    const sourceRecords = input.resolvedSources
+        .map(({ config, commitSha, retrievedAt, manifestDigest }) => ({
+        sourceId: config.sourceId,
+        displayName: config.displayName,
+        repositoryUrl: canonicalRepositoryUrl(config.repositoryUrl),
+        marketplaceDialect: config.marketplaceDialect,
+        manifestPath: config.manifestPath,
+        defaultBranch: config.defaultBranch,
+        resolvedCommitSha: commitSha,
+        retrievalTimestamp: retrievedAt,
+        trustClassification: config.trustClassification,
+        sourceManifestDigest: manifestDigest,
+        synchronizationStatus: 'synchronized',
+    }))
+        .toSorted((left, right) => left.sourceId.localeCompare(right.sourceId));
+    let plugins = [];
+    let skippedPlugins = [];
+    for (const source of input.resolvedSources) {
+        if (source.parsed.entries.length > policy.maxMarketplacePlugins)
+            throw new Error('MARKETPLACE_TOO_MANY_PLUGINS');
+        const normalized = await mapWithConcurrency(source.parsed.entries, 8, async (entry) => {
+            try {
+                const plugin = await normalizePlugin(source, entry, options);
+                try {
+                    return { plugin: PluginSchema.parse(plugin) };
+                }
+                catch {
+                    throw new PluginSafetyError('PLUGIN_SCHEMA_INVALID', []);
+                }
+            }
+            catch (error) {
+                const skipped = createSkippedPlugin(source, entry, error);
+                if (!skipped)
+                    throw error;
+                return { skipped };
+            }
+        });
+        const sourcePlugins = [];
+        const sourceSkipped = [];
+        for (const result of normalized) {
+            if (result.plugin)
+                sourcePlugins.push(result.plugin);
+            if (result.skipped)
+                sourceSkipped.push(result.skipped);
+        }
+        const weatherSkips = sourceSkipped.filter((skipped) => UPSTREAM_WEATHER_SKIP_CODES.has(skipped.reasonCode));
+        if (source.parsed.entries.length > 0 && weatherSkips.length === source.parsed.entries.length)
+            throw new PluginSafetyError('PLUGIN_SOURCE_UNAVAILABLE', [
+                canonicalRepositoryUrl(source.config.repositoryUrl),
+            ]);
+        for (const plugin of sourcePlugins)
+            plugins.push(plugin);
+        for (const skipped of sourceSkipped)
+            skippedPlugins.push(skipped);
+    }
+    plugins = plugins.toSorted((left, right) => left.pluginId.localeCompare(right.pluginId));
+    skippedPlugins = skippedPlugins.toSorted((left, right) => left.pluginId.localeCompare(right.pluginId) ||
+        left.reasonCode.localeCompare(right.reasonCode) ||
+        left.paths.join('\0').localeCompare(right.paths.join('\0')));
+    const body = {
+        schemaVersion: 1,
+        generatedAt: sourceRecords
+            .map((s) => s.retrievalTimestamp)
+            .toSorted()
+            .at(-1) ?? new Date(0).toISOString(),
+        sources: sourceRecords,
+        plugins: orderLeadingPlugins({ plugins }, input.leading).plugins,
+    };
+    return {
+        catalog: CatalogSchema.parse({
+            ...body,
+            catalogId: contentId('catalog', body),
+        }),
+        skippedPlugins,
+    };
+}
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

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

package/dist/capabilities.d.ts

@@ -0,0 +1,7 @@
+import { type CatalogPolicy } from './policy.js';
+import type { MarketplaceDialect } from './sources.js';
+import { type Capability, type Harness, type HarnessCompatibility, type SecurityClassification } from './schema.js';
+export declare function classifyCapabilities(files: ReadonlyMap<string, Uint8Array>, metadata?: Record<string, unknown>, policy?: CatalogPolicy): Capability[];
+export declare function capabilitySummary(capabilities: readonly Capability[]): Record<Capability['type'], number>;
+export declare function createCompatibility(dialect: MarketplaceDialect, capabilities: readonly Capability[], policy?: CatalogPolicy): Record<Harness, HarnessCompatibility>;
+export declare function createSecurity(capabilities: readonly Capability[], policy: CatalogPolicy, metadataOnly: boolean): SecurityClassification;

package/dist/capabilities.js

@@ -0,0 +1,116 @@
+import { basename } from 'node:path';
+import { DEFAULT_POLICY } from './policy.js';
+import { HarnessSchema, } from './schema.js';
+export function classifyCapabilities(files, metadata, policy = DEFAULT_POLICY) {
+    const groups = new Map();
+    const add = (type, path) => groups.set(type, [...(groups.get(type) ?? []), path]);
+    for (const path of files.keys()) {
+        const lower = path.toLocaleLowerCase();
+        const file = basename(lower);
+        if (file === 'skill.md' || lower.includes('/skills/'))
+            add('skill', path);
+        if (file === '.mcp.json' || file === 'mcp.json' || lower.includes('/mcp-servers/'))
+            add('mcp-server', path);
+        if (lower.includes('/commands/') || lower.startsWith('commands/'))
+            add('command', path);
+        if (lower.includes('/agents/') || lower.startsWith('agents/') || lower.includes('/subagents/'))
+            add('agent', path);
+        if (lower.includes('/hooks/') || lower.startsWith('hooks/') || file === 'hooks.json')
+            add('hook', path);
+        if (lower.includes('/rules/') ||
+            lower.startsWith('rules/') ||
+            file === 'agents.md' ||
+            file === 'claude.md' ||
+            lower.includes('.cursor/rules/'))
+            add('rule', path);
+        if (lower.includes('browser') || lower.includes('playwright') || lower.includes('chrome'))
+            add('browser', path);
+        if (lower.includes('/schedule') || lower.includes('/cron') || file.includes('schedule'))
+            add('scheduled-task', path);
+        if (lower.includes('/ui/') || lower.startsWith('ui/') || lower.includes('/components/'))
+            add('ui-component', path);
+        if (lower.startsWith('bin/') ||
+            lower.startsWith('scripts/') ||
+            /\.(sh|bash|py|exe|bin)$/.test(file))
+            add('executable', path);
+    }
+    if (metadata && (metadata.mcpServers !== undefined || metadata.mcp !== undefined))
+        add('mcp-server', 'plugin-manifest');
+    if (metadata && (metadata.hooks !== undefined || metadata.hook !== undefined))
+        add('hook', 'plugin-manifest');
+    if (groups.size === 0)
+        groups.set('unknown', ['plugin-root']);
+    return [...groups.entries()].map(([type, paths]) => ({
+        type: type,
+        name: type,
+        paths: [...new Set(paths)].toSorted(),
+        metadata: {},
+        securityImpact: policy.sensitiveCapabilityTypes.includes(type) ? 'sensitive' : 'none',
+    }));
+}
+export function capabilitySummary(capabilities) {
+    const summary = {};
+    for (const capability of capabilities)
+        summary[capability.type] = capability.paths.length;
+    return summary;
+}
+export function createCompatibility(dialect, capabilities, policy = DEFAULT_POLICY) {
+    const types = [...new Set(capabilities.map((capability) => capability.type))].toSorted();
+    const sensitive = types.filter((type) => policy.sensitiveCapabilityTypes.includes(type));
+    const make = (status, reasons) => ({
+        status,
+        reasons: [...new Set(reasons)].toSorted(),
+        responsibleCapabilities: types,
+    });
+    const result = {};
+    for (const harness of HarnessSchema.options) {
+        const native = (harness === 'claude-code' && dialect === 'claude') ||
+            (harness === 'cursor' && dialect === 'cursor') ||
+            (harness === 'codex' && dialect === 'openai');
+        if (types.includes('executable'))
+            result[harness] = make('unsupported', [
+                'Executable components require harness-specific execution authority.',
+            ]);
+        else if (types.includes('unknown'))
+            result[harness] = make('unknown', [
+                'The plugin content was not classified into a supported component type.',
+            ]);
+        else if (native && sensitive.length === 0)
+            result[harness] = make('native', [
+                `The ${dialect} marketplace dialect matches the ${harness} harness.`,
+            ]);
+        else if (sensitive.length > 0 && ['pi', 'hermes', 'opencode'].includes(harness))
+            result[harness] = make('partially-supported', [
+                `Sensitive capabilities require ${harness} policy and runtime review.`,
+                ...sensitive.map((type) => `Capability ${type} is not granted by this catalog.`),
+            ]);
+        else if (types.every((type) => ['skill', 'rule', 'mcp-server', 'command', 'agent'].includes(type)))
+            result[harness] = make(native ? 'native' : 'portable', native
+                ? [`The ${dialect} marketplace dialect matches the ${harness} harness.`]
+                : ['Files can be copied or translated into the harness layout.']);
+        else
+            result[harness] = make('requires-translation', [
+                'One or more capabilities need a harness-specific projection.',
+            ]);
+    }
+    return result;
+}
+export function createSecurity(capabilities, policy, metadataOnly) {
+    const sensitive = [
+        ...new Set(capabilities
+            .filter((capability) => policy.sensitiveCapabilityTypes.includes(capability.type))
+            .map((capability) => capability.type)),
+    ].toSorted();
+    const reasons = sensitive.length > 0
+        ? sensitive.map((type) => `Contains ${type} capability metadata.`)
+        : metadataOnly
+            ? ['Content was not fetched in metadata-only mode.']
+            : ['No permission-sensitive executable capability was detected.'];
+    return {
+        level: sensitive.length > 0 ? 'sensitive' : metadataOnly ? 'review' : 'low',
+        reasons,
+        permissionSensitiveChanges: sensitive,
+        contentResolution: metadataOnly ? 'metadata-only' : 'complete',
+    };
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

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

package/dist/catalog-store.d.ts

@@ -0,0 +1,76 @@
+export type PublicationStep = 'acquiring' | 'staged' | 'backed-up' | 'swapped' | 'cleaned';
+export interface CatalogCoordinationOptions {
+    /** How long to wait for another holder before failing; default 30 s. */
+    readonly waitMs?: number;
+    /** Heartbeat age after which a holder is considered dead; default 120 s. */
+    readonly staleAfterMs?: number;
+    /** Interval at which a holder refreshes its heartbeat; default 5 s. */
+    readonly heartbeatMs?: number;
+    /** Interval between lock attempts while waiting; default 50 ms. */
+    readonly pollMs?: number;
+    /** Test seam: called after each publication step while the lock is held. */
+    readonly onStep?: (step: PublicationStep) => void | Promise<void>;
+    /** Test seam: called once a lock is held. */
+    readonly onLocked?: (mode: LockMode) => void | Promise<void>;
+}
+export interface PublishOptions extends CatalogCoordinationOptions {
+    /**
+     * Fingerprint of the output the caller built from, as returned by
+     * {@link catalogFingerprint} inside {@link withCatalogRead}. When set, the
+     * publication fails with `CATALOG_BASE_CHANGED` if the output differs.
+     */
+    readonly expectedBase?: string;
+    /** Runs after the swap while the lock is still held, e.g. to publish an index. */
+    readonly afterPublish?: () => Promise<void>;
+}
+type LockMode = 'read' | 'write';
+export interface CatalogPaths {
+    readonly output: string;
+    readonly parent: string;
+    readonly backup: string;
+    readonly lock: string;
+    readonly owner: string;
+    readonly journal: string;
+    readonly stagePrefix: string;
+}
+/** Names the coordination files of one output, beside it in its real parent. */
+export declare function catalogPathsIn(parent: string, name: string): CatalogPaths;
+export declare class CatalogLock {
+    #private;
+    readonly paths: CatalogPaths;
+    readonly token: string;
+    constructor(paths: CatalogPaths, token: string, heartbeatMs: number);
+    /** Fails with `CATALOG_LOCK_LOST` if another process broke this lock. */
+    assertHeld(): Promise<void>;
+    release(): Promise<void>;
+}
+/**
+ * Completes or undoes an interrupted publication. Must run under the lock.
+ *
+ * | output | backup | staged dir | meaning                          | action         |
+ * | ------ | ------ | ---------- | -------------------------------- | -------------- |
+ * | yes    | no     | any        | not swapped, or already cleaned  | drop staging   |
+ * | no     | yes    | any        | died between the two renames     | roll back      |
+ * | yes    | yes    | no         | swapped, backup not yet removed  | roll forward   |
+ * | no     | no     | any        | first publication never swapped  | drop staging   |
+ * | yes    | yes    | yes        | inconsistent                     | stop, preserve |
+ */
+export declare function recoverCatalogOutput(paths: CatalogPaths): Promise<void>;
+/**
+ * A digest of the output's entries and bytes, or `absent`. Run it under the
+ * lock (inside {@link withCatalogRead}) so it describes a published state.
+ */
+export declare function catalogFingerprint(output: string): Promise<string>;
+/**
+ * Runs `read` while no writer can publish to `output`, after finishing any
+ * interrupted publication. Readers are serialized with writers and with each
+ * other; the lock is held only for the read itself.
+ */
+export declare function withCatalogRead<T>(output: string, read: () => Promise<T>, options?: CatalogCoordinationOptions): Promise<T>;
+/**
+ * Replaces `output` with exactly `files`. The previous output stays in place
+ * until the new one is complete, and a coordinated reader sees either one or
+ * the other.
+ */
+export declare function publishCatalog(output: string, files: Readonly<Record<string, string | Uint8Array>>, options?: PublishOptions): Promise<void>;
+export {};