Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,9 +77,9 @@ plugins/<plugin-name>/
- 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)
Expand Down
4 changes: 3 additions & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
{
Expand Down
Binary file added plugins/workiq/.claude-plugin/icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions plugins/workiq/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
2 changes: 1 addition & 1 deletion plugins/workiq/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
Binary file removed plugins/workiq/claude-package/icon.png
Binary file not shown.
37 changes: 28 additions & 9 deletions tests/workiq-guidance/static.test.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -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));
});
Expand Down
Loading