diff --git a/AGENTS.md b/AGENTS.md index 411b495..23cc811 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -77,9 +77,9 @@ 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. - - 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; 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 c6fadbb..dce9d5b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -60,7 +60,9 @@ plugins/{plugin-name}/ 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: +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/.claude-plugin/icon.png b/plugins/workiq/.claude-plugin/icon.png new file mode 100644 index 0000000..3ce1ca1 Binary files /dev/null and b/plugins/workiq/.claude-plugin/icon.png differ diff --git a/plugins/workiq/.claude-plugin/plugin.json b/plugins/workiq/.claude-plugin/plugin.json index 827c90b..ece063e 100644 --- a/plugins/workiq/.claude-plugin/plugin.json +++ b/plugins/workiq/.claude-plugin/plugin.json @@ -2,11 +2,11 @@ "name": "workiq", "displayName": "Work IQ", "version": "3.0.0", - "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.", "author": { "name": "Microsoft Corporation" }, - "icon": "./claude-package/icon.png", + "icon": "./.claude-plugin/icon.png", "privacyPolicyUrl": "https://www.microsoft.com/en-us/privacy/privacystatement", "supportUrl": "https://support.microsoft.com/en-us/contactus", "repository": "https://github.com/microsoft/work-iq", diff --git a/plugins/workiq/README.md b/plugins/workiq/README.md index 7b9d4c8..f38c0b0 100644 --- a/plugins/workiq/README.md +++ b/plugins/workiq/README.md @@ -55,7 +55,7 @@ and configuration wrappers are host-specific. ## Claude package Claude listing metadata is in `.claude-plugin/plugin.json`, with the icon in -`claude-package/icon.png`. Live Claude authentication and tool behavior require +`.claude-plugin/icon.png`. Live Claude authentication and tool behavior require separate verification. Keep generated ZIPs in the Git-ignored `artifacts` directory. This package does not change the existing Copilot configuration. diff --git a/plugins/workiq/claude-package/icon.png b/plugins/workiq/claude-package/icon.png deleted file mode 100644 index c3e1581..0000000 Binary files a/plugins/workiq/claude-package/icon.png and /dev/null differ diff --git a/tests/workiq-guidance/static.test.mjs b/tests/workiq-guidance/static.test.mjs index 1be2bdf..726d029 100644 --- a/tests/workiq-guidance/static.test.mjs +++ b/tests/workiq-guidance/static.test.mjs @@ -87,26 +87,45 @@ function checkMetadata(registries, manifests) { assert.ok(canonical, 'Missing stable marketplace entry'); assert.equal(canonical.version, '3.0.0'); assert.equal(canonical.source, './plugins/workiq'); - for (const manifest of manifests) { - for (const field of ['name', 'version', 'description']) { - assert.equal(manifest[field], canonical[field], `${field} differs across manifests`); + for (const [host, manifest] of Object.entries(manifests)) { + 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 marketplaces and host manifests publish consistent stable 3.0 metadata', () => { +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), - ['.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)); + manifests['.claude-plugin'].description = 'Customer-facing listing copy'; assert.doesNotThrow(() => checkMetadata(registries, manifests)); - manifests[0].version = '2.0.2'; + 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['.github/plugin'].description = entry.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)); });