@shard-for-obsidian/lib 0.3.1 → 0.3.3

package/dist/marketplace/index.d.ts

@@ -1,2 +1,4 @@
 export { MarketplaceClient, DEFAULT_MARKETPLACE_URL, type MarketplaceClientOptions, } from "./client.js";
+export { ociAnnotationsToFrontmatter, type PluginFrontmatter } from './oci-to-markdown.js';
+export { groupVersionsBySha, sortTagsByPriority, type RawVersion, type GroupedVersion, } from './version-grouping.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/marketplace/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/marketplace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/marketplace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,2BAA2B,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE3F,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,uBAAuB,CAAC"}

package/dist/marketplace/index.js

@@ -1 +1,3 @@
 export { MarketplaceClient, DEFAULT_MARKETPLACE_URL, } from "./client.js";
+export { ociAnnotationsToFrontmatter } from './oci-to-markdown.js';
+export { groupVersionsBySha, sortTagsByPriority, } from './version-grouping.js';

package/dist/marketplace/oci-to-markdown.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Frontmatter structure for marketplace markdown files
+ */
+export interface PluginFrontmatter {
+    id: string;
+    registryUrl: string;
+    name: string;
+    author: string;
+    description: string;
+    license?: string;
+    minObsidianVersion?: string;
+    authorUrl?: string;
+    repository?: string;
+    tags?: string[];
+}
+/**
+ * Transform OCI annotations to markdown frontmatter structure
+ */
+export declare function ociAnnotationsToFrontmatter(annotations: Record<string, string>, registryUrl: string): PluginFrontmatter;
+//# sourceMappingURL=oci-to-markdown.d.ts.map

package/dist/marketplace/oci-to-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oci-to-markdown.d.ts","sourceRoot":"","sources":["../../src/marketplace/oci-to-markdown.ts"],"names":[],"mappings":"AAqBA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,WAAW,EAAE,MAAM,GAClB,iBAAiB,CA2BnB"}

package/dist/marketplace/oci-to-markdown.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+/**
+ * Schema for OCI manifest annotations from Shard packages
+ */
+const OciAnnotationsSchema = z
+    .object({
+    'org.opencontainers.image.title': z.string().optional(),
+    'org.opencontainers.image.description': z.string().optional(),
+    'org.opencontainers.image.created': z.string().optional(),
+    'org.opencontainers.image.source': z.string().optional(),
+    'org.opencontainers.image.licenses': z.string().optional(),
+    'vnd.obsidianmd.plugin.id': z.string(),
+    'vnd.obsidianmd.plugin.name': z.string(),
+    'vnd.obsidianmd.plugin.author': z.string(),
+    'vnd.obsidianmd.plugin.description': z.string(),
+    'vnd.obsidianmd.plugin.source': z.string().optional(),
+    'vnd.obsidianmd.plugin.min-app-version': z.string().optional(),
+})
+    .passthrough();
+/**
+ * Transform OCI annotations to markdown frontmatter structure
+ */
+export function ociAnnotationsToFrontmatter(annotations, registryUrl) {
+    // Validate input
+    const validated = OciAnnotationsSchema.parse(annotations);
+    // Build frontmatter object
+    const frontmatter = {
+        id: validated['vnd.obsidianmd.plugin.id'],
+        name: validated['vnd.obsidianmd.plugin.name'],
+        author: validated['vnd.obsidianmd.plugin.author'],
+        description: validated['vnd.obsidianmd.plugin.description'],
+        registryUrl,
+    };
+    // Add optional fields
+    if (validated['vnd.obsidianmd.plugin.source']) {
+        frontmatter.repository = validated['vnd.obsidianmd.plugin.source'];
+    }
+    else if (validated['org.opencontainers.image.source']) {
+        frontmatter.repository = validated['org.opencontainers.image.source'];
+    }
+    if (validated['org.opencontainers.image.licenses']) {
+        frontmatter.license = validated['org.opencontainers.image.licenses'];
+    }
+    if (validated['vnd.obsidianmd.plugin.min-app-version']) {
+        frontmatter.minObsidianVersion = validated['vnd.obsidianmd.plugin.min-app-version'];
+    }
+    return frontmatter;
+}

package/dist/marketplace/version-grouping.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Version information before grouping
+ */
+export interface RawVersion {
+    tag: string;
+    sha: string;
+    publishedAt: string;
+    size: number;
+    annotations: Record<string, string>;
+}
+/**
+ * Version information after grouping by SHA
+ */
+export interface GroupedVersion {
+    sha: string;
+    canonicalTag: string;
+    additionalTags: string[];
+    publishedAt: string;
+    size: number;
+    annotations: Record<string, string>;
+}
+/**
+ * Sort tags by priority: full semver > partial semver > other
+ */
+export declare function sortTagsByPriority(tags: string[]): string[];
+/**
+ * Group versions by SHA digest, selecting canonical tag
+ */
+export declare function groupVersionsBySha(versions: RawVersion[]): GroupedVersion[];
+//# sourceMappingURL=version-grouping.d.ts.map

package/dist/marketplace/version-grouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-grouping.d.ts","sourceRoot":"","sources":["../../src/marketplace/version-grouping.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAY3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE,CA6C3E"}

package/dist/marketplace/version-grouping.js

@@ -0,0 +1,51 @@
+/**
+ * Sort tags by priority: full semver > partial semver > other
+ */
+export function sortTagsByPriority(tags) {
+    return tags.sort((a, b) => {
+        // Full semver (X.Y.Z) has highest priority
+        const aIsFullSemver = /^\d+\.\d+\.\d+/.test(a);
+        const bIsFullSemver = /^\d+\.\d+\.\d+/.test(b);
+        if (aIsFullSemver && !bIsFullSemver)
+            return -1;
+        if (!aIsFullSemver && bIsFullSemver)
+            return 1;
+        // Both same type: lexicographic comparison (numeric-aware, descending)
+        return b.localeCompare(a, undefined, { numeric: true });
+    });
+}
+/**
+ * Group versions by SHA digest, selecting canonical tag
+ */
+export function groupVersionsBySha(versions) {
+    // Build map of SHA -> version data
+    const versionMap = new Map();
+    for (const version of versions) {
+        const existing = versionMap.get(version.sha);
+        if (existing) {
+            existing.tags.push(version.tag);
+        }
+        else {
+            versionMap.set(version.sha, {
+                tags: [version.tag],
+                publishedAt: version.publishedAt,
+                size: version.size,
+                annotations: version.annotations,
+            });
+        }
+    }
+    // Convert to grouped versions with canonical tag selection
+    const grouped = Array.from(versionMap.entries()).map(([sha, data]) => {
+        const sorted = sortTagsByPriority(data.tags);
+        return {
+            sha,
+            canonicalTag: sorted[0],
+            additionalTags: sorted.slice(1),
+            publishedAt: data.publishedAt,
+            size: data.size,
+            annotations: data.annotations,
+        };
+    });
+    // Sort grouped versions by canonical tag (descending)
+    return grouped.sort((a, b) => sortTagsByPriority([a.canonicalTag, b.canonicalTag])[0] === a.canonicalTag ? -1 : 1);
+}

package/dist/oci/tags.d.ts

@@ -11,6 +11,7 @@ export interface QueryTagMetadataOptions {
     token?: string;
 }
 export interface TagMetadata {
+    digest: string;
     publishedAt: string;
     size: number;
     annotations: Record<string, string>;

package/dist/oci/tags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/oci/tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAyED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC,CAsCnB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAqDtB"}
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/oci/tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAyED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC,CAsCnB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAyDtB"}

package/dist/oci/tags.js

@@ -121,12 +121,15 @@ export async function queryTagMetadata(opts) {
         throw new Error(`Failed to query tag metadata: ${response.status} ${response.statusText}`);
     }
     const manifest = (await response.json());
+    // Extract digest from Docker-Content-Digest header
+    const digest = response.headers.get("docker-content-digest") || "";
     // Extract metadata
     const publishedAt = manifest.created || new Date().toISOString();
     const layerSizes = manifest.layers?.map((l) => l.size) || [];
     const size = layerSizes.reduce((sum, s) => sum + s, 0);
     const annotations = manifest.annotations || {};
     return {
+        digest,
         publishedAt,
         size,
         annotations,

package/dist/schemas/annotations.d.ts

@@ -14,7 +14,7 @@ export declare const PluginAnnotationsSchema: z.ZodObject<{
     "vnd.obsidianmd.plugin.description": z.ZodString;
     /** Plugin author */
     "vnd.obsidianmd.plugin.author": z.ZodString;
-    /** VCS source URL (e.g., git+https://github.com/owner/repo.git) */
+    /** Source URL (e.g., https://github.com/owner/repo) */
     "vnd.obsidianmd.plugin.source": z.ZodString;
     /** Publication timestamp (ISO 8601) */
     "vnd.obsidianmd.plugin.published-at": z.ZodString;
@@ -34,6 +34,8 @@ export declare const PluginAnnotationsSchema: z.ZodObject<{
     "org.opencontainers.image.source": z.ZodString;
     /** OCI standard: Plugin title */
     "org.opencontainers.image.title": z.ZodString;
+    /** OCI standard: Plugin description */
+    "org.opencontainers.image.description": z.ZodOptional<z.ZodString>;
     /** OCI standard: Creation timestamp (RFC 3339) */
     "org.opencontainers.image.created": z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -53,6 +55,7 @@ export declare const PluginAnnotationsSchema: z.ZodObject<{
     "vnd.obsidianmd.plugin.funding-url"?: string | undefined;
     "vnd.obsidianmd.plugin.converted"?: string | undefined;
     "vnd.obsidianmd.plugin.author-url"?: string | undefined;
+    "org.opencontainers.image.description"?: string | undefined;
 }, {
     "org.opencontainers.image.title": string;
     "vnd.obsidianmd.plugin.id": string;
@@ -70,6 +73,7 @@ export declare const PluginAnnotationsSchema: z.ZodObject<{
     "vnd.obsidianmd.plugin.funding-url"?: string | undefined;
     "vnd.obsidianmd.plugin.converted"?: string | undefined;
     "vnd.obsidianmd.plugin.author-url"?: string | undefined;
+    "org.opencontainers.image.description"?: string | undefined;
 }>;
 /**
  * Inferred TypeScript type from schema

package/dist/schemas/annotations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/schemas/annotations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,uBAAuB;IAClC,gBAAgB;;IAEhB,mBAAmB;;IAEnB,qBAAqB;;IAErB,yBAAyB;;IAEzB,oBAAoB;;IAEpB,mEAAmE;;IAEnE,uCAAuC;;IAEvC,iEAAiE;;IAEjE,gEAAgE;;IAEhE,oEAAoE;;IAEpE,wDAAwD;;IAExD,iBAAiB;;IAEjB,mDAAmD;;IAEnD,sCAAsC;;IAEtC,iCAAiC;;IAEjC,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAElD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/schemas/annotations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,uBAAuB;IAClC,gBAAgB;;IAEhB,mBAAmB;;IAEnB,qBAAqB;;IAErB,yBAAyB;;IAEzB,oBAAoB;;IAEpB,uDAAuD;;IAEvD,uCAAuC;;IAEvC,iEAAiE;;IAEjE,gEAAgE;;IAEhE,oEAAoE;;IAEpE,wDAAwD;;IAExD,iBAAiB;;IAEjB,mDAAmD;;IAEnD,sCAAsC;;IAEtC,iCAAiC;;IAEjC,uCAAuC;;IAEvC,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAElD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/schemas/annotations.js

@@ -14,8 +14,8 @@ export const PluginAnnotationsSchema = z.object({
     "vnd.obsidianmd.plugin.description": z.string(),
     /** Plugin author */
     "vnd.obsidianmd.plugin.author": z.string(),
-    /** VCS source URL (e.g., git+https://github.com/owner/repo.git) */
-    "vnd.obsidianmd.plugin.source": z.string().regex(/^git\+https:\/\//),
+    /** Source URL (e.g., https://github.com/owner/repo) */
+    "vnd.obsidianmd.plugin.source": z.string().url(),
     /** Publication timestamp (ISO 8601) */
     "vnd.obsidianmd.plugin.published-at": z.string().datetime(),
     /** Plugin introduction from community-plugins.json (required) */
@@ -34,6 +34,8 @@ export const PluginAnnotationsSchema = z.object({
     "org.opencontainers.image.source": z.string().url(),
     /** OCI standard: Plugin title */
     "org.opencontainers.image.title": z.string(),
+    /** OCI standard: Plugin description */
+    "org.opencontainers.image.description": z.string().optional(),
     /** OCI standard: Creation timestamp (RFC 3339) */
     "org.opencontainers.image.created": z.string().datetime(),
 });

package/dist/schemas/index.d.ts

@@ -1,5 +1,5 @@
 export { ObsidianManifestSchema, type ObsidianManifest } from "./manifest.js";
 export { PluginAnnotationsSchema, type PluginAnnotations, } from "./annotations.js";
 export { PluginVersionSchema, MarketplacePluginSchema, MarketplaceIndexSchema, CachedMarketplaceDataSchema, type PluginVersion, type MarketplacePlugin, type MarketplaceIndex, type CachedMarketplaceData, } from "./marketplace.js";
-export { repoToVcsUrl, vcsUrlToGitHubUrl, manifestToAnnotations, manifestToAnnotationsLegacy, annotationsToMarketplacePlugin, type CommunityPluginMetadata, } from "./transforms.js";
+export { repoToGitHubUrl, ghcrUrlToGitHubRepo, manifestToAnnotations, manifestToAnnotationsLegacy, annotationsToMarketplacePlugin, type CommunityPluginMetadata, } from "./transforms.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,EACL,uBAAuB,EACvB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC3B,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,2BAA2B,EAC3B,8BAA8B,EAC9B,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,EACL,uBAAuB,EACvB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC3B,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,8BAA8B,EAC9B,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAC"}

package/dist/schemas/index.js

@@ -3,4 +3,4 @@ export { ObsidianManifestSchema } from "./manifest.js";
 export { PluginAnnotationsSchema, } from "./annotations.js";
 export { PluginVersionSchema, MarketplacePluginSchema, MarketplaceIndexSchema, CachedMarketplaceDataSchema, } from "./marketplace.js";
 // Transform utilities
-export { repoToVcsUrl, vcsUrlToGitHubUrl, manifestToAnnotations, manifestToAnnotationsLegacy, annotationsToMarketplacePlugin, } from "./transforms.js";
+export { repoToGitHubUrl, ghcrUrlToGitHubRepo, manifestToAnnotations, manifestToAnnotationsLegacy, annotationsToMarketplacePlugin, } from "./transforms.js";

package/dist/schemas/marketplace.d.ts

@@ -3,8 +3,12 @@ import { z } from "zod";
  * Plugin version information from OCI registry
  */
 export declare const PluginVersionSchema: z.ZodObject<{
-    /** Version tag */
-    tag: z.ZodString;
+    /** Canonical version tag (highest priority) */
+    canonicalTag: z.ZodString;
+    /** Additional tags pointing to same SHA */
+    additionalTags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** SHA digest */
+    sha: z.ZodString;
     /** Publication timestamp (ISO 8601) */
     publishedAt: z.ZodString;
     /** Size in bytes */
@@ -14,13 +18,17 @@ export declare const PluginVersionSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     size: number;
     annotations: Record<string, string>;
-    tag: string;
+    canonicalTag: string;
+    sha: string;
     publishedAt: string;
+    additionalTags?: string[] | undefined;
 }, {
     size: number;
     annotations: Record<string, string>;
-    tag: string;
+    canonicalTag: string;
+    sha: string;
     publishedAt: string;
+    additionalTags?: string[] | undefined;
 }>;
 /**
  * Marketplace plugin information
@@ -51,8 +59,12 @@ export declare const MarketplacePluginSchema: z.ZodObject<{
     introduction: z.ZodOptional<z.ZodString>;
     /** Available versions from OCI */
     versions: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        /** Version tag */
-        tag: z.ZodString;
+        /** Canonical version tag (highest priority) */
+        canonicalTag: z.ZodString;
+        /** Additional tags pointing to same SHA */
+        additionalTags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** SHA digest */
+        sha: z.ZodString;
         /** Publication timestamp (ISO 8601) */
         publishedAt: z.ZodString;
         /** Size in bytes */
@@ -62,13 +74,17 @@ export declare const MarketplacePluginSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         size: number;
         annotations: Record<string, string>;
-        tag: string;
+        canonicalTag: string;
+        sha: string;
         publishedAt: string;
+        additionalTags?: string[] | undefined;
     }, {
         size: number;
         annotations: Record<string, string>;
-        tag: string;
+        canonicalTag: string;
+        sha: string;
         publishedAt: string;
+        additionalTags?: string[] | undefined;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     id: string;
@@ -85,8 +101,10 @@ export declare const MarketplacePluginSchema: z.ZodObject<{
     versions?: {
         size: number;
         annotations: Record<string, string>;
-        tag: string;
+        canonicalTag: string;
+        sha: string;
         publishedAt: string;
+        additionalTags?: string[] | undefined;
     }[] | undefined;
 }, {
     id: string;
@@ -103,8 +121,10 @@ export declare const MarketplacePluginSchema: z.ZodObject<{
     versions?: {
         size: number;
         annotations: Record<string, string>;
-        tag: string;
+        canonicalTag: string;
+        sha: string;
         publishedAt: string;
+        additionalTags?: string[] | undefined;
     }[] | undefined;
 }>;
 /**
@@ -137,8 +157,12 @@ export declare const MarketplaceIndexSchema: z.ZodObject<{
         introduction: z.ZodOptional<z.ZodString>;
         /** Available versions from OCI */
         versions: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            /** Version tag */
-            tag: z.ZodString;
+            /** Canonical version tag (highest priority) */
+            canonicalTag: z.ZodString;
+            /** Additional tags pointing to same SHA */
+            additionalTags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /** SHA digest */
+            sha: z.ZodString;
             /** Publication timestamp (ISO 8601) */
             publishedAt: z.ZodString;
             /** Size in bytes */
@@ -148,13 +172,17 @@ export declare const MarketplaceIndexSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             size: number;
             annotations: Record<string, string>;
-            tag: string;
+            canonicalTag: string;
+            sha: string;
             publishedAt: string;
+            additionalTags?: string[] | undefined;
         }, {
             size: number;
             annotations: Record<string, string>;
-            tag: string;
+            canonicalTag: string;
+            sha: string;
             publishedAt: string;
+            additionalTags?: string[] | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         id: string;
@@ -171,8 +199,10 @@ export declare const MarketplaceIndexSchema: z.ZodObject<{
         versions?: {
             size: number;
             annotations: Record<string, string>;
-            tag: string;
+            canonicalTag: string;
+            sha: string;
             publishedAt: string;
+            additionalTags?: string[] | undefined;
         }[] | undefined;
     }, {
         id: string;
@@ -189,8 +219,10 @@ export declare const MarketplaceIndexSchema: z.ZodObject<{
         versions?: {
             size: number;
             annotations: Record<string, string>;
-            tag: string;
+            canonicalTag: string;
+            sha: string;
             publishedAt: string;
+            additionalTags?: string[] | undefined;
         }[] | undefined;
     }>, "many">;
     /** Generation timestamp (ISO 8601) */
@@ -211,8 +243,10 @@ export declare const MarketplaceIndexSchema: z.ZodObject<{
         versions?: {
             size: number;
             annotations: Record<string, string>;
-            tag: string;
+            canonicalTag: string;
+            sha: string;
             publishedAt: string;
+            additionalTags?: string[] | undefined;
         }[] | undefined;
     }[];
     generatedAt: string;
@@ -232,8 +266,10 @@ export declare const MarketplaceIndexSchema: z.ZodObject<{
         versions?: {
             size: number;
             annotations: Record<string, string>;
-            tag: string;
+            canonicalTag: string;
+            sha: string;
             publishedAt: string;
+            additionalTags?: string[] | undefined;
         }[] | undefined;
     }[];
     generatedAt: string;
@@ -268,8 +304,12 @@ export declare const CachedMarketplaceDataSchema: z.ZodObject<{
         introduction: z.ZodOptional<z.ZodString>;
         /** Available versions from OCI */
         versions: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            /** Version tag */
-            tag: z.ZodString;
+            /** Canonical version tag (highest priority) */
+            canonicalTag: z.ZodString;
+            /** Additional tags pointing to same SHA */
+            additionalTags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /** SHA digest */
+            sha: z.ZodString;
             /** Publication timestamp (ISO 8601) */
             publishedAt: z.ZodString;
             /** Size in bytes */
@@ -279,13 +319,17 @@ export declare const CachedMarketplaceDataSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             size: number;
             annotations: Record<string, string>;
-            tag: string;
+            canonicalTag: string;
+            sha: string;
             publishedAt: string;
+            additionalTags?: string[] | undefined;
         }, {
             size: number;
             annotations: Record<string, string>;
-            tag: string;
+            canonicalTag: string;
+            sha: string;
             publishedAt: string;
+            additionalTags?: string[] | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         id: string;
@@ -302,8 +346,10 @@ export declare const CachedMarketplaceDataSchema: z.ZodObject<{
         versions?: {
             size: number;
             annotations: Record<string, string>;
-            tag: string;
+            canonicalTag: string;
+            sha: string;
             publishedAt: string;
+            additionalTags?: string[] | undefined;
         }[] | undefined;
     }, {
         id: string;
@@ -320,8 +366,10 @@ export declare const CachedMarketplaceDataSchema: z.ZodObject<{
         versions?: {
             size: number;
             annotations: Record<string, string>;
-            tag: string;
+            canonicalTag: string;
+            sha: string;
             publishedAt: string;
+            additionalTags?: string[] | undefined;
         }[] | undefined;
     }>, "many">;
     /** Fetch timestamp (Unix epoch milliseconds) */
@@ -342,8 +390,10 @@ export declare const CachedMarketplaceDataSchema: z.ZodObject<{
         versions?: {
             size: number;
             annotations: Record<string, string>;
-            tag: string;
+            canonicalTag: string;
+            sha: string;
             publishedAt: string;
+            additionalTags?: string[] | undefined;
         }[] | undefined;
     }[];
     fetchedAt: number;
@@ -363,8 +413,10 @@ export declare const CachedMarketplaceDataSchema: z.ZodObject<{
         versions?: {
             size: number;
             annotations: Record<string, string>;
-            tag: string;
+            canonicalTag: string;
+            sha: string;
             publishedAt: string;
+            additionalTags?: string[] | undefined;
         }[] | undefined;
     }[];
     fetchedAt: number;

package/dist/schemas/marketplace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../../src/schemas/marketplace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B,kBAAkB;;IAElB,uCAAuC;;IAEvC,oBAAoB;;IAEpB,+BAA+B;;;;;;;;;;;;EAE/B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB;IAElC,gBAAgB;;IAEhB,kDAAkD;;IAIlD,mBAAmB;;IAEnB,oBAAoB;;IAEpB,yBAAyB;;IAIzB,yBAAyB;;IAEzB,wCAAwC;;IAExC,iBAAiB;;IAIjB,6DAA6D;;IAE7D,oBAAoB;;IAIpB,oCAAoC;;IAEpC,kCAAkC;;QA9ClC,kBAAkB;;QAElB,uCAAuC;;QAEvC,oBAAoB;;QAEpB,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0C/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC,sBAAsB;;QAtCtB,gBAAgB;;QAEhB,kDAAkD;;QAIlD,mBAAmB;;QAEnB,oBAAoB;;QAEpB,yBAAyB;;QAIzB,yBAAyB;;QAEzB,wCAAwC;;QAExC,iBAAiB;;QAIjB,6DAA6D;;QAE7D,oBAAoB;;QAIpB,oCAAoC;;QAEpC,kCAAkC;;YA9ClC,kBAAkB;;YAElB,uCAAuC;;YAEvC,oBAAoB;;YAEpB,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkD/B,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEtC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,2BAA2B;IACtC,sBAAsB;;QAhDtB,gBAAgB;;QAEhB,kDAAkD;;QAIlD,mBAAmB;;QAEnB,oBAAoB;;QAEpB,yBAAyB;;QAIzB,yBAAyB;;QAEzB,wCAAwC;;QAExC,iBAAiB;;QAIjB,6DAA6D;;QAE7D,oBAAoB;;QAIpB,oCAAoC;;QAEpC,kCAAkC;;YA9ClC,kBAAkB;;YAElB,uCAAuC;;YAEvC,oBAAoB;;YAEpB,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4D/B,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEhD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}
+{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../../src/schemas/marketplace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B,+CAA+C;;IAE/C,2CAA2C;;IAE3C,iBAAiB;;IAEjB,uCAAuC;;IAEvC,oBAAoB;;IAEpB,+BAA+B;;;;;;;;;;;;;;;;EAE/B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB;IAElC,gBAAgB;;IAEhB,kDAAkD;;IAIlD,mBAAmB;;IAEnB,oBAAoB;;IAEpB,yBAAyB;;IAIzB,yBAAyB;;IAEzB,wCAAwC;;IAExC,iBAAiB;;IAIjB,6DAA6D;;IAE7D,oBAAoB;;IAIpB,oCAAoC;;IAEpC,kCAAkC;;QAlDlC,+CAA+C;;QAE/C,2CAA2C;;QAE3C,iBAAiB;;QAEjB,uCAAuC;;QAEvC,oBAAoB;;QAEpB,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0C/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC,sBAAsB;;QAtCtB,gBAAgB;;QAEhB,kDAAkD;;QAIlD,mBAAmB;;QAEnB,oBAAoB;;QAEpB,yBAAyB;;QAIzB,yBAAyB;;QAEzB,wCAAwC;;QAExC,iBAAiB;;QAIjB,6DAA6D;;QAE7D,oBAAoB;;QAIpB,oCAAoC;;QAEpC,kCAAkC;;YAlDlC,+CAA+C;;YAE/C,2CAA2C;;YAE3C,iBAAiB;;YAEjB,uCAAuC;;YAEvC,oBAAoB;;YAEpB,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkD/B,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEtC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,2BAA2B;IACtC,sBAAsB;;QAhDtB,gBAAgB;;QAEhB,kDAAkD;;QAIlD,mBAAmB;;QAEnB,oBAAoB;;QAEpB,yBAAyB;;QAIzB,yBAAyB;;QAEzB,wCAAwC;;QAExC,iBAAiB;;QAIjB,6DAA6D;;QAE7D,oBAAoB;;QAIpB,oCAAoC;;QAEpC,kCAAkC;;YAlDlC,+CAA+C;;YAE/C,2CAA2C;;YAE3C,iBAAiB;;YAEjB,uCAAuC;;YAEvC,oBAAoB;;YAEpB,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4D/B,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEhD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/dist/schemas/marketplace.js

@@ -3,8 +3,12 @@ import { z } from "zod";
  * Plugin version information from OCI registry
  */
 export const PluginVersionSchema = z.object({
-    /** Version tag */
-    tag: z.string(),
+    /** Canonical version tag (highest priority) */
+    canonicalTag: z.string(),
+    /** Additional tags pointing to same SHA */
+    additionalTags: z.array(z.string()).optional(),
+    /** SHA digest */
+    sha: z.string(),
     /** Publication timestamp (ISO 8601) */
     publishedAt: z.string(),
     /** Size in bytes */

package/dist/schemas/transforms.d.ts

@@ -2,19 +2,12 @@ import type { ObsidianManifest } from "./manifest.js";
 import type { PluginAnnotations } from "./annotations.js";
 import type { MarketplacePlugin } from "./marketplace.js";
 /**
- * Convert GitHub repo format to VCS URL
+ * Convert GitHub repo format to GitHub URL
  * @param repo - Repository in "owner/repo" format
- * @returns VCS URL in "git+https://github.com/owner/repo.git" format
- * @throws Error if repo format is invalid
- */
-export declare function repoToVcsUrl(repo: string): string;
-/**
- * Extract GitHub URL from VCS URL
- * @param vcsUrl - VCS URL in "git+https://..." format
  * @returns GitHub URL in "https://github.com/owner/repo" format
- * @throws Error if VCS URL format is invalid
+ * @throws Error if repo format is invalid
  */
-export declare function vcsUrlToGitHubUrl(vcsUrl: string): string;
+export declare function repoToGitHubUrl(repo: string): string;
 /**
  * Extract GitHub repository URL from GHCR registry URL
  * @param registryUrl - GHCR URL (e.g., "ghcr.io/owner/repo/path")

package/dist/schemas/transforms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transforms.d.ts","sourceRoot":"","sources":["../../src/schemas/transforms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUxD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAc/D;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC,CA8B5B;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,gBAAgB,EAC1B,eAAe,EAAE,uBAAuB,EACxC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAgCnB;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,iBAAiB,EAC9B,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAyBnB"}
+{"version":3,"file":"transforms.d.ts","sourceRoot":"","sources":["../../src/schemas/transforms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAc/D;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC,CA+B5B;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,gBAAgB,EAC1B,eAAe,EAAE,uBAAuB,EACxC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAiCnB;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,iBAAiB,EAC9B,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAyBnB"}

package/dist/schemas/transforms.js

@@ -1,28 +1,14 @@
 /**
- * Convert GitHub repo format to VCS URL
+ * Convert GitHub repo format to GitHub URL
  * @param repo - Repository in "owner/repo" format
- * @returns VCS URL in "git+https://github.com/owner/repo.git" format
+ * @returns GitHub URL in "https://github.com/owner/repo" format
  * @throws Error if repo format is invalid
  */
-export function repoToVcsUrl(repo) {
+export function repoToGitHubUrl(repo) {
     if (!repo.includes("/")) {
         throw new Error(`Invalid repo format: ${repo}. Expected "owner/repo"`);
     }
-    return `git+https://github.com/${repo}.git`;
-}
-/**
- * Extract GitHub URL from VCS URL
- * @param vcsUrl - VCS URL in "git+https://..." format
- * @returns GitHub URL in "https://github.com/owner/repo" format
- * @throws Error if VCS URL format is invalid
- */
-export function vcsUrlToGitHubUrl(vcsUrl) {
-    if (!vcsUrl.startsWith("git+")) {
-        throw new Error(`Invalid VCS URL format: ${vcsUrl}. Expected "git+https://..."`);
-    }
-    // Remove "git+" prefix and optional ".git" suffix
-    const url = vcsUrl.slice(4).replace(/\.git$/, "");
-    return url;
+    return `https://github.com/${repo}`;
 }
 /**
  * Extract GitHub repository URL from GHCR registry URL
@@ -55,8 +41,9 @@ export function manifestToAnnotationsLegacy(manifest, ownerRepo, registryUrl) {
         "vnd.obsidianmd.plugin.name": manifest.name,
         "vnd.obsidianmd.plugin.version": manifest.version,
         "vnd.obsidianmd.plugin.description": manifest.description,
+        "org.opencontainers.image.description": manifest.description,
         "vnd.obsidianmd.plugin.author": manifest.author,
-        "vnd.obsidianmd.plugin.source": repoToVcsUrl(ownerRepo),
+        "vnd.obsidianmd.plugin.source": repoToGitHubUrl(ownerRepo),
         "vnd.obsidianmd.plugin.is-desktop-only": String(manifest.isDesktopOnly ?? false),
         "vnd.obsidianmd.plugin.min-app-version": manifest.minAppVersion,
         "org.opencontainers.image.source": ghcrUrlToGitHubRepo(registryUrl),
@@ -92,10 +79,11 @@ export function manifestToAnnotations(manifest, communityPlugin, registryUrl, pu
         "vnd.obsidianmd.plugin.name": manifest.name,
         "vnd.obsidianmd.plugin.version": manifest.version,
         "vnd.obsidianmd.plugin.description": manifest.description,
+        "org.opencontainers.image.description": manifest.description,
         "vnd.obsidianmd.plugin.author": manifest.author,
-        "vnd.obsidianmd.plugin.source": repoToVcsUrl(communityPlugin.repo),
+        "vnd.obsidianmd.plugin.source": repoToGitHubUrl(communityPlugin.repo),
         "vnd.obsidianmd.plugin.published-at": publishedAt,
-        "vnd.obsidianmd.plugin.introduction": communityPlugin.introduction ?? "",
+        "vnd.obsidianmd.plugin.introduction": communityPlugin.description,
         "vnd.obsidianmd.plugin.is-desktop-only": String(manifest.isDesktopOnly ?? false),
         "vnd.obsidianmd.plugin.min-app-version": manifest.minAppVersion,
         "org.opencontainers.image.source": ghcrUrlToGitHubRepo(registryUrl),
@@ -139,10 +127,10 @@ export function annotationsToMarketplacePlugin(annotations, registryUrl) {
         plugin.minObsidianVersion =
             annotations["vnd.obsidianmd.plugin.min-app-version"];
     }
-    // Extract GitHub URL from source
+    // Source is already a GitHub URL
     const source = annotations["vnd.obsidianmd.plugin.source"];
     if (source) {
-        plugin.repository = vcsUrlToGitHubUrl(source);
+        plugin.repository = source;
     }
     return plugin;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shard-for-obsidian/lib",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "type": "module",
   "description": "Core library for Shard plugin management",
   "author": "Andrew Gillis",
@@ -39,6 +39,7 @@
     "zod": "^3.24.1"
   },
   "devDependencies": {
+    "@vitest/coverage-v8": "^4.0.18",
     "@vitest/ui": "^4.0.18",
     "vitest": "^4.0.18"
   },
@@ -48,6 +49,7 @@
     "ts-check": "tsc --noEmit",
     "lint": "eslint .",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "test:watch": "vitest",
     "test:ui": "vitest --ui"
   }