From 8029d71eb0713c26757965c47e2cf141bc3ce2d8 Mon Sep 17 00:00:00 2001 From: Sean Laberee Date: Mon, 16 Nov 2026 20:40:22 -0800 Subject: [PATCH 1/2] Update Claude listing copy, icon, and authentication guidance Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 85562efa-a5e2-44b7-a3c8-105513af93e4 --- .claude-plugin/marketplace.json | 2 +- AGENTS.md | 5 ++- CONTRIBUTING.md | 8 +++- plugins/workiq/.claude-plugin/icon.png | Bin 0 -> 12412 bytes plugins/workiq/.claude-plugin/plugin.json | 4 +- plugins/workiq/README.md | 51 +++++++++++++++++++++- plugins/workiq/claude-package/icon.png | Bin 20157 -> 0 bytes tests/workiq-guidance/static.test.mjs | 35 +++++++++++---- 8 files changed, 88 insertions(+), 17 deletions(-) create mode 100644 plugins/workiq/.claude-plugin/icon.png delete mode 100644 plugins/workiq/claude-package/icon.png diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 9192b51..402f4da 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -7,7 +7,7 @@ "plugins": [ { "name": "workiq", - "description": "WorkIQ for Microsoft 365 mail, calendar, Teams, files, SharePoint, people, Planner and Business Applications. Use retrieve with source-based strategy selection to find evidence and summarize locally. Use ask only for a requested Copilot or named-agent answer; use entity tools for specific reads and operations, with confirmation before mutations. If workiq and workiq-preview are both installed, prefer workiq-preview only if its installed version is higher than workiq's; otherwise prefer workiq.", + "description": "Bring your Microsoft 365 work context into Claude.", "version": "3.0.0", "source": "./plugins/workiq" }, diff --git a/AGENTS.md b/AGENTS.md index 411b495..9ef252a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -77,9 +77,10 @@ plugins// - OpenAI listing names and descriptions use neutral WorkIQ/Microsoft 365 wording; check that those fields do not reference AI assistant/model brands before submission. Preserve factual backend prerequisites and tool documentation outside listing copy rather than hiding service dependencies. Listing theme colors are configured with `brandColor` and `brandColorDark` under `extensions.com.openai.interface` in the submission manifest. - OpenAI submission OAuth declares `extensions.com.openai.auth.defaultScopes` using the fully qualified `WorkIQAgent.Act` scope and a provided-client ID; verify both survive in packaged root `mcp.json`. OpenAI does not accept `clientSecret` in the manifest; enter real secrets only in connection setup/the submission portal. - OpenAI review scenarios follow the unchanged shared skill: ordinary document summaries use `retrieve` with grounding and optional `fetch` metadata verification; exact-subject email summaries use `fetch`, never implicit `ask` delegation. Report unavailable retrieval or missing ownership evidence without inventing an owner. - - Claude submission assets use the existing Claude manifest and `plugins/workiq/claude-package/icon.png`; no Claude submission README is included. Reuse unchanged skills and use a URL-only HTTP MCP configuration without Copilot OAuth fields. Keep generated submission ZIPs in the Git-ignored `artifacts` directory; root `workiq-*.zip` outputs are also ignored to prevent accidental commits. Live Claude OAuth and tool behavior require separate verification. + - Claude submission assets use the existing Claude manifest and `plugins/workiq/.claude-plugin/icon.png`; no Claude submission README is included. Reuse unchanged skills and use a URL-only HTTP MCP configuration without Copilot OAuth fields. Keep generated submission ZIPs in the Git-ignored `artifacts` directory; root `workiq-*.zip` outputs are also ignored to prevent accidental commits. Live Claude OAuth and tool behavior require separate verification. + - Anthropic's Work IQ Entra client ID is `9d24ba1b-a182-46b1-9455-0efcf0bafae1`. Configure this Anthropic-held client in the Claude MCP connector's developer-portal authentication settings, not as an invented plugin-manifest field or a replacement for shared Copilot/OpenAI settings. The Claude.ai redirect URI is `https://claude.ai/api/mcp/auth_callback`; Claude Code uses a separate OAuth path. Keep client secrets out of the repository. See the [Claude authentication guidance](plugins/workiq/README.md#claude-connector-authentication). - - The Claude manifest (`plugins/workiq/.claude-plugin/plugin.json`) uses `workiq` as its machine identifier and `Work IQ` as its display name, and references the transparent `claude-package/icon.png` at the same path in the Claude ZIP. Listing URLs are configured in the manifest; configure classification in the submission portal, not the manifest. + - The Claude manifest (`plugins/workiq/.claude-plugin/plugin.json`) uses `workiq` as its machine identifier and `Work IQ` as its display name, and references the transparent 1024 x 1024 `.claude-plugin/icon.png` at the same path in the Claude ZIP. Its `description` is a short user-facing tagline mirrored in the Claude marketplace, intentionally distinct from other hosts' descriptions. The longer approved copy lives in [the plugin README](plugins/workiq/README.md#claude-directory-listing) for submission through the portal; do not invent tagline or long-description manifest fields. Model instructions remain in the shared skill. Listing URLs are configured in the manifest; configure classification in the submission portal, not the manifest. The public preview package is retired. Do not recreate it or register it. Existing installations must follow [migration instructions](README.md#migrating-from-workiq-preview) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c6fadbb..7a698e8 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -59,8 +59,12 @@ plugins/{plugin-name}/ ### Marketplace Registry All public plugins must be registered consistently in `marketplace.json` and -`.claude-plugin/marketplace.json`. Keep name, version and description consistent -with the plugin's host manifests. Add your plugin entry: +`.claude-plugin/marketplace.json`. Keep name and version consistent with the +plugin's host manifests. Descriptions should also match, except that Work IQ's +Claude marketplace and Claude manifest share a customer-facing tagline rather +than the other hosts' discovery description. Keep the longer Claude listing copy +in the existing [plugin README](plugins/workiq/README.md#claude-directory-listing) +for the submission portal. Add your plugin entry: ```json { diff --git a/plugins/workiq/.claude-plugin/icon.png b/plugins/workiq/.claude-plugin/icon.png new file mode 100644 index 0000000000000000000000000000000000000000..3ce1ca11fd5a1445d8401f492e5c3d0aa92ef330 GIT binary patch literal 12412 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 **OAuth sign-in** +> **OAuth client**, using Anthropic-held client credentials. Configure any +required client secret only through the authorized portal setup, never in the +repository, plugin manifest or MCP configuration. Tenant administrator consent +is still required; recording the client ID here does not grant consent or change +the live listing. + +The connector's OAuth client is managed separately from the GitHub-backed +plugin bundle. Do not replace the shared Copilot or OpenAI client settings +with this ID. Claude Code uses a separate OAuth path; do not assume this +confidential client and Claude.ai callback can be reused there. See +[Anthropic's connector authentication requirements](https://claude.com/docs/connectors/building/authentication#anthropic-held-client-credentials). + +### Claude directory listing + +The manifest's `description` is the user-facing tagline, also mirrored in the +Claude marketplace entry. Use the longer description below in the submission +portal; the manifest has no documented long-description field. Model instructions +remain in the shared skill, not the listing copy. + +**Tagline:** Bring your Microsoft 365 work context into Claude. + +**Description:** Bring your Microsoft 365 work context into Claude with Work IQ, +built by Microsoft. Find and connect information across Outlook email and calendar, +Teams conversations, and SharePoint and OneDrive files to prepare for meetings, +catch up on projects, and turn scattered information into clear next steps. Use +those insights to inform analysis in Microsoft Fabric and Power BI, and to shape +agents and AI experiences built with Microsoft Foundry. Get answers grounded in +work information you're permitted to access, with source links when available, +and take supported actions with your confirmation. Work IQ respects your +organization's access controls and requires a Microsoft 365 work or school +account, administrator consent, and applicable licensing. + ## Choosing the operation | Request | Route | diff --git a/plugins/workiq/claude-package/icon.png b/plugins/workiq/claude-package/icon.png deleted file mode 100644 index c3e1581b3f7f2644063daadb0eaae883b11fc633..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 20157 zcmeHOdr(x@89xg|KxIMg_~PkU!x%|OpaHfbU_jB>pkwj}M!~BF9a~cf%ebHfZm~@; zQ810h5LW3V?J!9lvuUOY(KT%9ShOrlGpk`cKt$2q(BP94B*4(`JLg_vSRlM*^?Wnj zd(OS*@qNGVbJGv*Dpay*BA z>F7sqZ6PEfVrAUY=Q0(|b*J`kNcov~DfHXF>*l|reE82(>wdRN49QPhK4(qdVqIlg zgm30vuRm&n-`nqYV8!*q%&y3D+b?xwBp;ar<8$H&a0EC490861M}Q;15#R`L1ULc{ z5CO3}Z7#8#ElDje&n^l+tRP1p{aBmY7SVD+x=BCb~CjZ+BPJe$a@$7V6r=KMgk**On!mf4!*EZ0-z$_9u(mo5FJZiN#Pa z%ig`)NiMp1$)y;P5V1wc@4HIB#g@ln@JeZb_W0h(g*79K+pRgror(7} zsZLM=pn?|Mk&;F9xnXGnonBbhKNr}#XH?=9fORC1C|Ch@uT*%fNrJt)j^ZRNpu`e^c51{#ovu2~l8QSQkQ)lwI@{7{c!0Ts>De#QO z7#yI-t*|(JiFHL4MKqd7+{0i}Ou%tR3H|0PHJ<7@)SYoupxy(Ed$iW3NPHv3piNQ? z>LWOe0fVD6B!o2eU6G<8qTl%T6Z2WlZ49+3#Qk!>X}!G+ENbVlEedh{an`~oK)uy~ z&&1v#ydkFKVzP-Eq!Tm9Z!YMmk(0mvC>3IFpg|3a4Fh8EN(l`(>|;Gn#KOTlrZQah0sz} z(p~Ew)^WI_vEFv3hmRk?AuYy`N(}ZumOrpNT>JN{&MK2{UEw^Pbwq2fj^B=nx?|I2hc}bO*^_G{@`%UkjnS8)&^ZB+Y>x~<4e(>}O_w(y!CNf#>rUMOKv);q!W%+t#%{;Zt(a1vdJK;sV3$7g9q(L#o&vq+>&4}wmMwBsDbkWZtiMCxP zy*D8_Up8j9mTV85;Y2zu^_?2IIlns+0?CD2h;S(P<+73wt*fKg?bcRi@6)6P$5tNp z_p`P&7pkLISI;8HTCG`8-~UGQmFi-2`D*{%Fi^UFYjw-TTeiZ^_(`PvauqQ=vax!W z+ITp6UB~HcZEnunDFt_2YgC@6Q#A$8O&6COwbr+E`9J$VeS7ZFmK;Lve9?Zb^IH3@ zHih^Qq#t3A58x&~V>G^ zA@l-BW(D9wq`uf_Ed#iI&fXJCEJV?@;}S)iA!jD8p!0tE-Sum5sFg`iQ5Hz7^vNul zK<7UIXDyf-`S71A)Q%(yQ+e_}S&9M9=4g{qjs9%XQ693+1iB$4IiHOV*FFs10knne z_vHY?u_YFes`xWOY_IJ`j|osIF(QpZJ5@(Ya6>0d zbCy&^T=1WPChgtOcTTuu#O}WKI8+5u(X0f(;u@)p))tqFHnMlu4S4t=-Nnpk}r4oI`4-CE@Uoi z7HL@SKvtnMXTd*Xz}-gt$X4DgUs6?Z zaEZ}Y-KK}!l53iAL;8^vV#|pmz!BgGa0EC490861N8mw0;LeM#O8Rxwr7QQEN6&Hl hgCahc({T| plugin.name !== 'workiq-preview')); const canonical = registries[0].plugins.find(plugin => plugin.name === 'workiq'); + const claude = registries[1].plugins.find(plugin => plugin.name === 'workiq'); assert.ok(canonical, 'Missing stable marketplace entry'); + assert.ok(claude, 'Missing Claude marketplace entry'); + assert.equal(typeof claude.description, 'string'); + assert.ok(claude.description.trim(), 'Missing Claude listing tagline'); + assert.deepEqual(registries[1], { + ...registries[0], + plugins: registries[0].plugins.map(plugin => + plugin.name === 'workiq' ? { ...plugin, description: claude.description } : plugin) + }); assert.equal(canonical.version, '3.0.0'); assert.equal(canonical.source, './plugins/workiq'); - for (const manifest of manifests) { + for (const [host, manifest] of Object.entries(manifests)) { + const expected = host === '.claude-plugin' ? claude : canonical; for (const field of ['name', 'version', 'description']) { - assert.equal(manifest[field], canonical[field], `${field} differs across manifests`); + assert.equal(manifest[field], expected[field], `${host}: ${field} differs from its marketplace`); } assert.equal(manifest.skills, './skills/'); } } -test('all marketplaces and host manifests publish consistent stable 3.0 metadata', () => { +test('all hosts publish consistent stable 3.0 metadata with matching host-specific descriptions', () => { const json = file => JSON.parse(fs.readFileSync(path.join(root, file), 'utf8')); checkMetadata(['marketplace.json', '.claude-plugin/marketplace.json'].map(json), - ['.github/plugin', '.claude-plugin', '.codex-plugin'].map(host => json(`plugins/workiq/${host}/plugin.json`))); + Object.fromEntries(['.github/plugin', '.claude-plugin', '.codex-plugin'] + .map(host => [host, json(`plugins/workiq/${host}/plugin.json`)]))); }); -test('metadata contract rejects mismatched hosts and retired preview registration', () => { +test('metadata contract permits Claude listing copy but rejects mismatches and retired preview registration', () => { const entry = { name: 'workiq', version: '3.0.0', source: './plugins/workiq', description: 'Synthetic' }; const registries = Array.from({ length: 2 }, () => ({ plugins: [structuredClone(entry)] })); - const manifests = Array.from({ length: 3 }, () => ({ ...entry, skills: './skills/' })); + const manifests = Object.fromEntries(['.github/plugin', '.claude-plugin', '.codex-plugin'] + .map(host => [host, { ...entry, skills: './skills/' }])); + assert.doesNotThrow(() => checkMetadata(registries, manifests)); + registries[1].plugins[0].description = 'Customer-facing listing copy'; + manifests['.claude-plugin'].description = 'Customer-facing listing copy'; assert.doesNotThrow(() => checkMetadata(registries, manifests)); - manifests[0].version = '2.0.2'; + manifests['.claude-plugin'].description = 'Mismatched listing copy'; + assert.throws(() => checkMetadata(registries, manifests), /description differs/); + manifests['.claude-plugin'].description = registries[1].plugins[0].description; + manifests['.github/plugin'].version = '2.0.2'; assert.throws(() => checkMetadata(registries, manifests), /version differs/); - manifests[0].version = '3.0.0'; + manifests['.github/plugin'].version = '3.0.0'; for (const registry of registries) registry.plugins.push({ name: 'workiq-preview' }); assert.throws(() => checkMetadata(registries, manifests)); }); From 45a4e906b590d52dc7130dae96ac28df59b1518b Mon Sep 17 00:00:00 2001 From: Sean Laberee Date: Mon, 16 Nov 2026 20:47:59 -0800 Subject: [PATCH 2/2] Restore marketplace discovery text and remove Claude README additions Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 85562efa-a5e2-44b7-a3c8-105513af93e4 --- .claude-plugin/marketplace.json | 2 +- AGENTS.md | 3 +- CONTRIBUTING.md | 10 +++--- plugins/workiq/README.md | 49 --------------------------- tests/workiq-guidance/static.test.mjs | 34 ++++++++++--------- 5 files changed, 24 insertions(+), 74 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 402f4da..9192b51 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -7,7 +7,7 @@ "plugins": [ { "name": "workiq", - "description": "Bring your Microsoft 365 work context into Claude.", + "description": "WorkIQ for Microsoft 365 mail, calendar, Teams, files, SharePoint, people, Planner and Business Applications. Use retrieve with source-based strategy selection to find evidence and summarize locally. Use ask only for a requested Copilot or named-agent answer; use entity tools for specific reads and operations, with confirmation before mutations. If workiq and workiq-preview are both installed, prefer workiq-preview only if its installed version is higher than workiq's; otherwise prefer workiq.", "version": "3.0.0", "source": "./plugins/workiq" }, diff --git a/AGENTS.md b/AGENTS.md index 9ef252a..23cc811 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -78,9 +78,8 @@ plugins// - OpenAI submission OAuth declares `extensions.com.openai.auth.defaultScopes` using the fully qualified `WorkIQAgent.Act` scope and a provided-client ID; verify both survive in packaged root `mcp.json`. OpenAI does not accept `clientSecret` in the manifest; enter real secrets only in connection setup/the submission portal. - OpenAI review scenarios follow the unchanged shared skill: ordinary document summaries use `retrieve` with grounding and optional `fetch` metadata verification; exact-subject email summaries use `fetch`, never implicit `ask` delegation. Report unavailable retrieval or missing ownership evidence without inventing an owner. - Claude submission assets use the existing Claude manifest and `plugins/workiq/.claude-plugin/icon.png`; no Claude submission README is included. Reuse unchanged skills and use a URL-only HTTP MCP configuration without Copilot OAuth fields. Keep generated submission ZIPs in the Git-ignored `artifacts` directory; root `workiq-*.zip` outputs are also ignored to prevent accidental commits. Live Claude OAuth and tool behavior require separate verification. - - Anthropic's Work IQ Entra client ID is `9d24ba1b-a182-46b1-9455-0efcf0bafae1`. Configure this Anthropic-held client in the Claude MCP connector's developer-portal authentication settings, not as an invented plugin-manifest field or a replacement for shared Copilot/OpenAI settings. The Claude.ai redirect URI is `https://claude.ai/api/mcp/auth_callback`; Claude Code uses a separate OAuth path. Keep client secrets out of the repository. See the [Claude authentication guidance](plugins/workiq/README.md#claude-connector-authentication). - - The Claude manifest (`plugins/workiq/.claude-plugin/plugin.json`) uses `workiq` as its machine identifier and `Work IQ` as its display name, and references the transparent 1024 x 1024 `.claude-plugin/icon.png` at the same path in the Claude ZIP. Its `description` is a short user-facing tagline mirrored in the Claude marketplace, intentionally distinct from other hosts' descriptions. The longer approved copy lives in [the plugin README](plugins/workiq/README.md#claude-directory-listing) for submission through the portal; do not invent tagline or long-description manifest fields. Model instructions remain in the shared skill. Listing URLs are configured in the manifest; configure classification in the submission portal, not the manifest. + - The Claude manifest (`plugins/workiq/.claude-plugin/plugin.json`) uses `workiq` as its machine identifier and `Work IQ` as its display name, and references the transparent 1024 x 1024 `.claude-plugin/icon.png` at the same path in the Claude ZIP. Its `description` is a short user-facing tagline; both marketplace registries retain the shared model-facing discovery text. Model instructions remain in the shared skill. Listing URLs are configured in the manifest; configure classification in the submission portal, not the manifest. The public preview package is retired. Do not recreate it or register it. Existing installations must follow [migration instructions](README.md#migrating-from-workiq-preview) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 7a698e8..dce9d5b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -59,12 +59,10 @@ plugins/{plugin-name}/ ### Marketplace Registry All public plugins must be registered consistently in `marketplace.json` and -`.claude-plugin/marketplace.json`. Keep name and version consistent with the -plugin's host manifests. Descriptions should also match, except that Work IQ's -Claude marketplace and Claude manifest share a customer-facing tagline rather -than the other hosts' discovery description. Keep the longer Claude listing copy -in the existing [plugin README](plugins/workiq/README.md#claude-directory-listing) -for the submission portal. Add your plugin entry: +`.claude-plugin/marketplace.json`. Keep name, version and description consistent +with the plugin's host manifests, except that Work IQ's Claude manifest may use a +customer-facing tagline. Both marketplace registries retain the same model-facing +discovery description. Add your plugin entry: ```json { diff --git a/plugins/workiq/README.md b/plugins/workiq/README.md index 8703e80..f38c0b0 100644 --- a/plugins/workiq/README.md +++ b/plugins/workiq/README.md @@ -32,9 +32,6 @@ Tenant consent and appropriate licensing are required; see ## Hosted MCP configuration -This example is for GitHub Copilot. Its OAuth fields are not the Claude -connector's authentication settings. - ```json { "mcpServers": { @@ -62,52 +59,6 @@ Claude listing metadata is in `.claude-plugin/plugin.json`, with the icon in separate verification. Keep generated ZIPs in the Git-ignored `artifacts` directory. This package does not change the existing Copilot configuration. -### Claude connector authentication - -For Claude.ai, Claude Desktop, mobile and Cowork, configure the Work IQ -connector with Anthropic-held OAuth client credentials: - -| Setting | Value | -| --- | --- | -| MCP server URL | `https://workiq.svc.cloud.microsoft/mcp` | -| Anthropic's Entra application (client) ID | `9d24ba1b-a182-46b1-9455-0efcf0bafae1` | -| Required delegated API permission | `WorkIQ.Act` | -| Redirect URI | `https://claude.ai/api/mcp/auth_callback` | - -Set the client in the [Claude developer portal](https://claude.ai/directory/manage) -for the Work IQ MCP connector under **How users authenticate** > **OAuth sign-in** -> **OAuth client**, using Anthropic-held client credentials. Configure any -required client secret only through the authorized portal setup, never in the -repository, plugin manifest or MCP configuration. Tenant administrator consent -is still required; recording the client ID here does not grant consent or change -the live listing. - -The connector's OAuth client is managed separately from the GitHub-backed -plugin bundle. Do not replace the shared Copilot or OpenAI client settings -with this ID. Claude Code uses a separate OAuth path; do not assume this -confidential client and Claude.ai callback can be reused there. See -[Anthropic's connector authentication requirements](https://claude.com/docs/connectors/building/authentication#anthropic-held-client-credentials). - -### Claude directory listing - -The manifest's `description` is the user-facing tagline, also mirrored in the -Claude marketplace entry. Use the longer description below in the submission -portal; the manifest has no documented long-description field. Model instructions -remain in the shared skill, not the listing copy. - -**Tagline:** Bring your Microsoft 365 work context into Claude. - -**Description:** Bring your Microsoft 365 work context into Claude with Work IQ, -built by Microsoft. Find and connect information across Outlook email and calendar, -Teams conversations, and SharePoint and OneDrive files to prepare for meetings, -catch up on projects, and turn scattered information into clear next steps. Use -those insights to inform analysis in Microsoft Fabric and Power BI, and to shape -agents and AI experiences built with Microsoft Foundry. Get answers grounded in -work information you're permitted to access, with source links when available, -and take supported actions with your confirmation. Work IQ respects your -organization's access controls and requires a Microsoft 365 work or school -account, administrator consent, and applicable licensing. - ## Choosing the operation | Request | Route | diff --git a/tests/workiq-guidance/static.test.mjs b/tests/workiq-guidance/static.test.mjs index a9f7b6b..726d029 100644 --- a/tests/workiq-guidance/static.test.mjs +++ b/tests/workiq-guidance/static.test.mjs @@ -81,29 +81,26 @@ test('same-objective follow-ups require the repair owner, including after succes }); function checkMetadata(registries, manifests) { + assert.deepEqual(registries[1], registries[0]); assert.ok(registries[0].plugins.every(plugin => plugin.name !== 'workiq-preview')); const canonical = registries[0].plugins.find(plugin => plugin.name === 'workiq'); - const claude = registries[1].plugins.find(plugin => plugin.name === 'workiq'); assert.ok(canonical, 'Missing stable marketplace entry'); - assert.ok(claude, 'Missing Claude marketplace entry'); - assert.equal(typeof claude.description, 'string'); - assert.ok(claude.description.trim(), 'Missing Claude listing tagline'); - assert.deepEqual(registries[1], { - ...registries[0], - plugins: registries[0].plugins.map(plugin => - plugin.name === 'workiq' ? { ...plugin, description: claude.description } : plugin) - }); assert.equal(canonical.version, '3.0.0'); assert.equal(canonical.source, './plugins/workiq'); for (const [host, manifest] of Object.entries(manifests)) { - const expected = host === '.claude-plugin' ? claude : canonical; - for (const field of ['name', 'version', 'description']) { - assert.equal(manifest[field], expected[field], `${host}: ${field} differs from its marketplace`); + for (const field of ['name', 'version']) { + assert.equal(manifest[field], canonical[field], `${host}: ${field} differs from its marketplace`); + } + if (host === '.claude-plugin') { + assert.equal(typeof manifest.description, 'string'); + assert.ok(manifest.description.trim(), 'Missing Claude listing tagline'); + } else { + assert.equal(manifest.description, canonical.description, `${host}: description differs from its marketplace`); } assert.equal(manifest.skills, './skills/'); } } -test('all hosts publish consistent stable 3.0 metadata with matching host-specific descriptions', () => { +test('marketplaces share stable 3.0 metadata while the Claude manifest may use a listing tagline', () => { const json = file => JSON.parse(fs.readFileSync(path.join(root, file), 'utf8')); checkMetadata(['marketplace.json', '.claude-plugin/marketplace.json'].map(json), Object.fromEntries(['.github/plugin', '.claude-plugin', '.codex-plugin'] @@ -115,12 +112,17 @@ test('metadata contract permits Claude listing copy but rejects mismatches and r const manifests = Object.fromEntries(['.github/plugin', '.claude-plugin', '.codex-plugin'] .map(host => [host, { ...entry, skills: './skills/' }])); assert.doesNotThrow(() => checkMetadata(registries, manifests)); - registries[1].plugins[0].description = 'Customer-facing listing copy'; manifests['.claude-plugin'].description = 'Customer-facing listing copy'; assert.doesNotThrow(() => checkMetadata(registries, manifests)); - manifests['.claude-plugin'].description = 'Mismatched listing copy'; + registries[1].plugins[0].description = 'Mismatched registry copy'; + assert.throws(() => checkMetadata(registries, manifests)); + registries[1].plugins[0].description = entry.description; + manifests['.claude-plugin'].description = ' '; + assert.throws(() => checkMetadata(registries, manifests), /Missing Claude listing tagline/); + manifests['.claude-plugin'].description = 'Customer-facing listing copy'; + manifests['.github/plugin'].description = 'Mismatched discovery copy'; assert.throws(() => checkMetadata(registries, manifests), /description differs/); - manifests['.claude-plugin'].description = registries[1].plugins[0].description; + manifests['.github/plugin'].description = entry.description; manifests['.github/plugin'].version = '2.0.2'; assert.throws(() => checkMetadata(registries, manifests), /version differs/); manifests['.github/plugin'].version = '3.0.0';