blomios/IdeaSDK

Go to file

Blomios 2a3c582ec8 merge(sdk): fix #329 — feedbacks menu host génériques et doc SDK alignée (QA verte: npm run check, git diff --check) — docs only, aucun push

2026-09-19 00:33:57 +02:00

docs(sdk): feedbacks menu host génériques — #329 ; README + docs commands-and-feedback/menus/services : failed/skipped sans message Git codé en dur ni payload brut, opened/alreadyOpen succès silencieux, logs host pluginId/commandId/status/reason/message, vue de diagnostic reste accessible quand Git/ADB/Gradle ou autre outil optionnel manque, workspace.execTool rappelé ; QA verte : npm run check, git diff --check

2026-09-19 00:33:57 +02:00

examples/hello-plugin

feat(sdk): pluginRoot officiel exposé dans activate(ctx) — #285 (src/runtime: champ pluginRoot = racine du package installé; docs activation-context/commands-and-feedback/services/manifest réécrits du constat d'absence vers le contrat d'usage officiel — runCommand reste project-scoped, pluginRoot utilisable dans command/args, substitution manifest ${pluginRoot}/${appDataDir} inchangée pour mcpServers; exemple hello-plugin: script packagé scripts/hello-task.mjs consommé via ctx.pluginRoot, packaging étendu; QA verte: npm run check — build, typecheck:examples, package:hello-plugin, artefact zip vérifié)

2026-09-08 18:35:24 +02:00

feat(sdk): contrat permissions.workspaceExec pour l'exécution contrôlée via l'hôte — #346

2026-09-13 12:07:56 +02:00

feat(sdk): contrat permissions.workspaceExec pour l'exécution contrôlée via l'hôte — #346

2026-09-13 12:07:56 +02:00

.gitignore

Initial commit: IdeaSDK TypeScript plugin SDK

2026-08-02 16:24:59 +02:00

package-lock.json

feat(runtime): résout react/react-dom vers l'instance host pour les layouts plugin

2026-08-04 00:39:25 +02:00

package.json

feat(sdk): metadata statiques contributes.mcpServers[].tools — #296 (type IdeAPluginMcpToolMetadata {name exact non vide, description optionnelle non vide} exporté public; validation manifest: tools optionnel, noms uniques par serveur — metadata d'affichage pour l'UI d'attribution de capacités, ne remplace ni ne cache MCP tools/list et n'enregistre rien; scripts/check-manifest-tools.mjs + npm run test:manifest intégré à check: optionnel/valide/doublon rejeté; doc manifest.md: exemple unity_get_scene/run_tests + règles; QA verte reconfirmée par Git: npm run check)

2026-09-09 19:52:23 +02:00

README.md

docs(sdk): feedbacks menu host génériques — #329 ; README + docs commands-and-feedback/menus/services : failed/skipped sans message Git codé en dur ni payload brut, opened/alreadyOpen succès silencieux, logs host pluginId/commandId/status/reason/message, vue de diagnostic reste accessible quand Git/ADB/Gradle ou autre outil optionnel manque, workspace.execTool rappelé ; QA verte : npm run check, git diff --check

2026-09-19 00:33:57 +02:00

tsconfig.json

Initial commit: IdeaSDK TypeScript plugin SDK

2026-08-02 16:24:59 +02:00

README.md

IdeA Plugin SDK

Public TypeScript SDK for IdeA plugins.

The SDK defines the stable manifest and runtime types used by plugins loaded by IdeA. A plugin ships an idea-plugin.json manifest plus an ESM entrypoint that exports activate(ctx).

Start Here

Manifest: required fields, capabilities and contribution ids.
Activation And Context: activate(ctx), lifecycle, logging, storage and subscriptions.
Menus: top-level menus, native menu insertion and command registration.
Commands And Feedback: command return values, skipped work and background tasks.
Layouts With React: React/JSX/hooks layout authoring with host-provided React.
Windows: opening plugin layouts in detached OS windows.
Services: workspace files and bounded workspace.execTool, tasks, tooling, events, config, terminal and windows facades.
Packaging And Distribution: build output, archive layout, hot reload and dependency rules.
Codex Skills And IdeA Plugins: separate IdeA-native plugin skills from Codex plugin discovery.
Project Plugin Assignments: enable plugins per project and assign skills and MCP tools to agents.

The installable example lives in examples/hello-plugin. It demonstrates a menu command, storage, background-task feedback, a React layout component and services.windows.open(...).

For short project-scoped external tools, use ctx.services.workspace.execTool() with an explicit manifest permissions.workspaceExec allow rule. See Services and Manifest. The primitive is generic and does not expose a native Git/SCM API.

Menu commands that open or focus a plugin view return status: "opened" (including alreadyOpen: true) and remain UI-silent on success. Keep diagnostic views accessible when optional tools are missing, and use the structured skipped/failed feedback contract for genuinely impossible actions; see Commands And Feedback and Menus.

Install

npm install

Build

npm run build

Validate The Example

npm run typecheck:examples
npm run package:hello-plugin

The example archive is written to:

examples/hello-plugin/build/hello-plugin-0.1.0.zip